CodeIgniter4配置JWT过滤器报错：类App\Filters\FilterJwt未找到

问题描述 #

在CodeIgniter4（CI4）中开发JWT过滤器时，已将FilterJwt.php文件放置在app/Filters目录下，在app/Config/Filters.php中完成过滤器配置后，始终抛出**“Class "App\Filters\FilterJwt" not found”**错误。尝试在app路径下新建AuthFilter目录并调整配置，问题仍未解决。

相关代码 #

/app/Config/Filters.php #

<?php

namespace Config;

use App\Filters\FilterJwt;
use CodeIgniter\Config\BaseConfig;
use CodeIgniter\Filters\CSRF;
use CodeIgniter\Filters\DebugToolbar;
use CodeIgniter\Filters\Honeypot;
use CodeIgniter\Filters\InvalidChars;
use CodeIgniter\Filters\SecureHeaders;

class Filters extends BaseConfig
{
    /**
     * 配置过滤器类别名，简化调用
     */
    public array $aliases = [
        'csrf'          => CSRF::class,
        'toolbar'       => DebugToolbar::class,
        'honeypot'      => Honeypot::class,
        'invalidchars'  => InvalidChars::class,
        'secureheaders' => SecureHeaders::class,
        'authentication' => FilterJwt::class
    ];

    /**
     * 全局生效的过滤器（所有请求前后都执行）
     */
    public array $globals = [
        'before' => [
            // 'honeypot',
            // 'csrf',
            // 'invalidchars',
        ],
        'after' => [
            'toolbar',
            // 'honeypot',
            // 'secureheaders',
        ],
    ];

    /**
     * 针对特定HTTP方法生效的过滤器
     */
    public array $methods = [];

    /**
     * 针对特定URI模式生效的过滤器
     */
    public $filters = [
        'authentication' => [
            'before' => [
                'users/*',
                'users'
            ]
        ]
    ];
}

/app/Filters/FilterJwt.php #

<?php

namespace App\Filters;

use CodeIgniter\Filters\FilterInterface;
use CodeIgniter\HTTP\RequestInterface;
use CodeIgniter\HTTP\ResponseInterface;

use CodeIgniter\API\ResponseTrait;
use Exception;

class MyFilter implements FilterInterface
{
    use ResponseTrait;
    public function before(RequestInterface $request, $arguments = null)
    {
        $header = $request->getServer('HTTP_AUTHORIZATION');
        try {
            helper('jwt');
            $encodedToken = getJwt($header);
            checkJWT($encodedToken);
            return $request;
        } catch (Exception $e) {
            return Services::response()->setJson([
                'error' => $e->getMessage()
            ])->setStatusCode(ResponseInterface::HTTP_UNAUTHORIZED);
        }
    }

    public function after(RequestInterface $request, ResponseInterface $response, $arguments = null)
    {
        // 后续处理逻辑
    }
}

文件与错误说明 #

• 文件存在证明：截图显示/app/Filters/FilterJwt.php文件确实存在于对应目录中。
• CI4错误提示：截图显示框架抛出**“Class "App\Filters\FilterJwt" not found”**的错误信息。

解决方案 #

核心修复：类名与文件名不一致 #

这是导致错误的直接原因：FilterJwt.php文件中定义的类名是MyFilter，但配置文件中引用的是FilterJwt类。

1. 修改/app/Filters/FilterJwt.php中的类名，将class MyFilter改为class FilterJwt，确保类名与文件名完全一致：

// 修改后
class FilterJwt implements FilterInterface
{
    // 原有逻辑保持不变
}

2. 检查命名空间：确保文件顶部的命名空间为namespace App\Filters;，与目录结构匹配。

3. 刷新CI4自动加载缓存：
   执行以下命令清除框架缓存，确保自动加载器能识别到修改后的类：

php spark cache:clear
php spark autoload

额外排查点（若问题仍存在） #

• 大小写检查：Linux/macOS环境下文件名区分大小写，确保FilterJwt.php的大小写与配置中的类名完全一致（首字母大写，其余符合驼峰命名）。
• 目录结构：确认app/Filters目录存在，且权限正常，框架能读取该目录下的文件。
• 命名空间引用：检查Config/Filters.php中的use App\Filters\FilterJwt;语句是否正确，无拼写错误。

内容的提问来源于stack exchange，提问作者Rafly Andrian