mirror of https://gitee.com/hyperf/hyperf.git synced 2024-12-01 03:08:06 +08:00

Co-authored-by: 李铭昕 <715557344@qq.com>

2022-03-27 17:01:45 +08:00

8.6 KiB

Raw Blame History

常見問題

Swoole 短名未關閉

[ERROR] Swoole short function names must be disabled before the server starts, please set swoole.use_shortname = 'Off' in your php.ini.

您需要在您的 php.ini 配置文件增加 swoole.use_shortname = 'Off' 配置項

注意該配置必須於 php.ini 內配置，無法通過 ini_set() 函數來重寫

當然，也可以通過以下的命令來啟動服務，在執行 PHP 命令時關閉掉 Swoole 短名功能

php -d swoole.use_shortname=Off bin/hyperf.php start

異步隊列消息丟失

如果在使用 async-queue 組件時，發現 handle 中的方法沒有執行，請先檢查以下幾種情況：

Redis 是否與其他人共用，消息被其他人消費走
本地進程是否存在殘餘，被其他進程消費掉

以下提供萬無一失的解決辦法：

killall php
修改 async-queue 配置 channel

使用 AMQP 組件報 `Swoole\Error: API must be called in the coroutine` 錯誤

可以在 config/autoload/amqp.php 配置文件中將 params.close_on_destruct 改為 false 即可。

使用 Swoole 4.5 版本和 view 組件時訪問接口出現 404

使用 Swoole 4.5 版本和 view 組件如果出現接口 404 的問題，可以嘗試刪除 config/autoload/server.php 文件中的 static_handler_locations 配置項。

此配置下的路徑都會被認為是靜態文件路由，所以如果配置了/，就會導致所有接口都會被認為是文件路徑，導致接口 404。

代碼不生效

當碰到修改後的代碼不生效的問題，請執行以下命令

composer dump-autoload -o

開發階段，請不要設置 scan_cacheable 為 true，它會導致 收集器緩存 存在時，不會再次掃描文件。另外，官方骨架包中的 Dockerfile 是默認開啟這個配置的，Docker 環境下開發的同學，請注意這裏。

當環境變量存在 SCAN_CACHEABLE 時，.env 中無法修改這個配置。

語法錯誤導致服務無法啟動

當項目啟動時，拋出類似於以下錯誤時

Fatal error: Uncaught PhpParser\Error: Syntax error, unexpected T_STRING on line 27 in vendor/nikic/php-parser/lib/PhpParser/ParserAbstract.php:315

可以執行腳本 composer analyse，對項目進行靜態檢測，便可以找到出現問題的代碼段。

此問題通常是由於 zircote/swagger 的 3.0.5 版本更新導致, 詳情請見 #834 。如果安裝了 hyperf/swagger 建議將 zircote/swagger 的版本鎖定在 3.0.4

內存限制太小導致項目無法運行

PHP 默認的 memory_limit 只有 128M，因為 Hyperf 使用了 BetterReflection，不使用掃描緩存時，會消耗大量內存，所以可能會出現內存不夠的情況。

我們可以使用 php -d memory_limit=-1 bin/hyperf.php start 運行, 或者修改 php.ini 配置文件

# 查看 php.ini 配置文件位置
php --ini

# 修改 memory_limit 配置
memory_limit=-1

PHP 7.3 版本對 DI 的兼容性有所下降

在 2.0 - 2.1 版本時，為了實現 AOP 作用於非 DI 管理的對象（如 new 關鍵詞實例化的對象時），底層實現採用了 BetterReflection 組件來實現相關功能，帶來新的編程體驗的同時，也帶來了一些很難攻克的問題，如下:

無掃描緩存時項目啟動很慢
特殊場景下 Inject 和 Value 不生效
BetterReflection 尚未支持 PHP 8 (截止 2.2 發版時)

在新的版本里，棄用了 BetterReflection 的應用，採用了 子進程掃描 的方式來解決以上這些痛點，但在低版本的 PHP 中也有一些不兼容的情況：

使用 PHP 7.3 啟動應用後遇到類似如下錯誤：

PHP Fatal error:  Interface 'Hyperf\Signal\SignalHandlerInterface' not found in vendor/hyperf/process/src/Handler/ProcessStopHandler.php on line 17

PHP Fatal error:  Interface 'Symfony\Component\Serializer\SerializerInterface' not found in vendor/hyperf/utils/src/Serializer/Serializer.php on line 46

此問題是由於在 PHP 7.3 中通過 子進程掃描 的方式去獲取反射，在某個類中實現了一個不存在的 Interface ，就會導致拋出 Interface not found 的異常，而高版本的 PHP 則不會。

解決方法為創建對應的 Interface 並正常引入。上文中的報錯解決方法為安裝對應所依賴的組件即可。

當然，最好還是可以升級到 7.4 或者 8.0 版本

composer require hyperf/signal

composer require symfony/serializer

Trait 內使用 `@Inject` 注入報錯 `Error while injecting dependencies into ... No entry or class found ...`

若 Trait 通過 @Inject @var 注入屬性, 同時子類裏 use 了不同命名空間的同名類, 會導致 Trait 裏類名被覆蓋，進而導致注入失效:

use Hyperf\HttpServer\Contract\ResponseInterface;
use Hyperf\Di\Annotation\Inject;

trait TestTrait
{
    /**
     * @Inject()   
     * @var ResponseInterface
     */
    protected $response;
}

如上 Trait 類注入 Hyperf\HttpServer\Contract\ResponseInterface, 若子類使用不同命名空間的ResponseInterface 類, 如use Psr\Http\Message\ResponseInterface, 會導致 Trait 原類名被覆蓋:

// use 同類名會覆蓋Trait
use Psr\Http\Message\ResponseInterface;

class IndexController
{
    use TestTrait;
}
// Error while injecting dependencies into App\Controller\IndexController: No entry or class found for 'Psr\Http\Message\ResponseInterface'

上述問題可以通過以下兩個方法解決:

子類通過 as 修改別名: use Psr\Http\Message\ResponseInterface as PsrResponseInterface;
Trait 類PHP7.4 以上通過屬性類型限制: protected ResponseInterface $response;

Grpc 擴展或未安裝 Pcntl 導致項目無法啟動

v2.2 版本的註解掃描使用了 pcntl 擴展，所以請先確保您的 PHP 安裝了此擴展。

php --ri pcntl

pcntl

pcntl support => enabled

當開啟 grpc 的時候，需要添加 grpc.enable_fork_support= 1; 到 php.ini 中，以支持開啟子進程。

HTTP Server 將 `open_websocket_protocol` 設置為 `false` 後啟動報錯：`Swoole\Server::start(): require onReceive callback`

檢查 Swoole 是否編譯了 http2

php --ri swoole | grep http2
http2 => enabled

如果沒有，需要重新編譯 Swoole 並增加 --enable-http2 參數。

檢查 server.php 文件中 open_http2_protocol 選項是否為 true。

Command 無法正常關閉

在 Command 中使用 AMQP 等多路複用技術後，會導致無法正常關閉，碰到這種情況只需要在執行邏輯最後增加以下代碼即可。

<?php
use Hyperf\Utils\Coordinator\CoordinatorManager;
use Hyperf\Utils\Coordinator\Constants;

CoordinatorManager::until(Constants::WORKER_EXIT)->resume();

ORM 不支持 bit 類型

若想要使 ORM 支持 bit 類型，只需要增加以下監聽器代碼即可。

<?php

declare(strict_types=1);

namespace App\Listener;

use Hyperf\Database\Connection;
use Hyperf\Database\MySqlBitConnection;
use Hyperf\Event\Annotation\Listener;
use Hyperf\Event\Contract\ListenerInterface;
use Hyperf\Framework\Event\BootApplication;

#[Listener]
class SupportMySQLBitListener implements ListenerInterface
{
    public function listen(): array
    {
        return [
            BootApplication::class,
        ];
    }

    public function process(object $event)
    {
        Connection::resolverFor('mysql', static function ($connection, $database, $prefix, $config) {
            return new MySqlBitConnection($connection, $database, $prefix, $config);
        });
    }
}

OSS 上傳組件報 iconv 錯誤

fix aliyun oss wrong charset: https://github.com/aliyun/aliyun-oss-php-sdk/issues/101
https://github.com/docker-library/php/issues/240#issuecomment-762438977
https://github.com/docker-library/php/pull/1264

當使用 aliyuncs/oss-sdk-php 組件上傳時，會報 iconv 錯誤，可以嘗試使用以下方式規避：

使用 hyperf/hyperf:8.0-alpine-v3.12-swoole 鏡像時

RUN apk --no-cache --allow-untrusted --repository http://dl-cdn.alpinelinux.org/alpine/edge/community/ add gnu-libiconv=1.15-r2
ENV LD_PRELOAD /usr/lib/preloadable_libiconv.so

使用 hyperf/hyperf:8.0-alpine-v3.13-swoole 鏡像時

RUN apk add --no-cache --repository http://dl-cdn.alpinelinux.org/alpine/v3.13/community/ gnu-libiconv=1.15-r3
ENV LD_PRELOAD /usr/lib/preloadable_libiconv.so php

8.6 KiB Raw Blame History