中间件类名大小写必须严格匹配文件名和命名空间，否则PSR-4自动加载失败导致Class not found；Linux下尤其敏感，Windows可能误判；配置、接口实现、多应用均需逐一校验大小写一致性。
中间件类名大小写不匹配会导致类加载失败
ThinkPHP 6+ 完全依赖 Composer 的 PSR-4 自动加载机制，类名与文件名必须严格一致，包括大小写。哪怕只是首字母小写，也会触发 Class not found 错误，且框架不会兜底或提示“可能大小写错了”。
- 类名是
App\Middleware\Auth，文件就必须叫app/middleware/Auth.php（不是auth.php或AuthMiddleware.php） - Linux 服务器上
app/middleware/auth.php和app/middleware/Auth.php是两个不同文件，前者永远无法被加载 - Windows 下可能“碰巧能跑”，但部署到生产环境（通常是 Linux）时立即报错，属于高发线上事故
- 检查方法：在终端执行
php -r "var_dump(class_exists('app\middleware\Auth'));"，返回bool(false)就说明类没注册成功
全局中间件配置中类名大小写写错会静默失效
app/middleware.php 是纯配置文件，不支持 use 语句，所有类名必须带完整命名空间并以反斜杠开头。这里写错大小写，中间件就彻底不进执行链，没有任何日志、无报错、无 fallback。
- ✅ 正确：
return [\app\middleware\Auth::class];（注意开头反斜杠和Auth首字母大写） - ❌ 错误：
return ['app\middleware\Auth']（缺反斜杠，PHP 在当前命名空间下找，报Class 'app\middleware\app\middleware\Auth' not found） - ❌ 错误：
return [\App\Middleware\Auth::class]（App大写，实际命名空间是app，大小写错 → 类不存在） - TP8 在 PHP 8.1+ 下还会因反射失败抛出
BindingResolutionException，但错误堆栈指向容器而非你写的中间件文件
自定义中间件类定义时大小写影响接口实现
ThinkPHP 8.0 强制要求中间件类实现 think\contract\MiddlewareInterface，而该接口的 handle() 方法有返回类型声明。如果类名本身大小写不对，连接口都加载不到，更别说类型校验了。
- TP6 允许无接口的
handle()方法，但若你写了implements MiddlewareInterface，而MiddlewareInterface的命名空间路径因大小写错没加载，就会报Interface 'think\contract\middlewareinterface' not found（注意全小写） - 常见低级错误：
use think\contract\middlewareinterface;（应为MiddlewareInterface，首字母 M 和 I 必须大写） - 别用 IDE 自动导入补全来赌运气——它可能把
MiddlewareInterface导成小写，保存后即失效
多应用模式下每个子应用的中间件路径都要单独校验大小写
ThinkPHP 的多应用模式不共享 app/middleware.php，每个子应用（如 admin、api）都有自己的 app/admin/middleware.php 和 app/admin/middleware/ 目录。大小写问题在这里会重复出现，且相互隔离。
立即学习“PHP免费学习笔记（深入）”；
- 例如
app/api/middleware/JwtAuth.php文件存在，但类定义是class jwtAuth（小写 j），则app/api/middleware.php中写\app\api\middleware\JwtAuth::class依然失败 - 别假设“主应用能跑，子应用就一定行”——子应用的命名空间是
app\api\middleware，路径、类名、文件名三者必须在该上下文中重新对齐 - CI/CD 流程中建议加一步校验脚本：
find app -name "*.php" -exec basename {} \; | grep -v "^[A-Z]"，快速扫出非首字母大写的 PHP 文件
auth.php 文件。 
