ThinkPHP自动路由对控制器名大小写敏感是因为默认用strtolower()处理URL中的控制器名，再按PSR-4规范加载类，而Linux文件系统区分大小写导致类加载失败。
ThinkPHP 自动路由为什么对控制器名大小写敏感
因为 ThinkPHP 默认用 strtolower() 处理 URL 中的控制器名，再拼接命名空间去反射类，而 PHP 类加载器（PSR-4）本身区分大小写——Linux 服务器上一旦类文件名是 IndexController.php，但路由解析出 indexcontroller，就会找不到类。
- Windows 开发环境常“不报错”，只是掩盖问题；部署到 Linux 就直接
ClassNotFoundException - 自动路由（
route/true）开启后，index/index→ 解析为Index控制器，但若 URL 写成INDEX/index或index/Index，默认策略会转成全小写，导致类名匹配失败 - 不是框架 bug，是设计选择：优先保证 PSR-4 规范一致性，而非牺牲可移植性迁就 URL 输入随意性
如何让控制器名大小写自动归一化（推荐方案）
在应用初始化阶段拦截并标准化控制器名，比改核心路由类更安全、可维护。关键是在 app/common.php 或 app/provider.php 中注册一个请求前的钩子：
// app/common.php
app()->beforeStart(function (\think\Request $request) {
$pathinfo = $request->path();
if (preg_match('#^([a-zA-Z][a-zA-Z0-9]*)/#', $pathinfo, $matches)) {
$controllerName = ucfirst(strtolower($matches[1]));
$request->setPathinfo(preg_replace('#^([a-zA-Z][a-zA-Z0-9]*)/#', $controllerName . '/', $pathinfo));
}
});
- 只处理路径第一段（即控制器名），保留后续方法名/参数原样，避免误伤
user/login这类合法小写路径 - 用
ucfirst(strtolower())统一为首字母大写 + 其余小写，兼容user、USER、UsEr等输入 - 不要在
Route::rule()里硬编码重写，那会绕过自动路由机制，失去动态映射能力
命名空间与实际文件路径不一致时的典型错误
比如控制器类声明为 app\controller\UserController，但文件放在 app/controller/user.php（小写文件名），就会触发 Class 'app\controller\UserController' not found。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- Linux 下文件系统严格区分大小写，
user.php≠UserController.php - ThinkPHP 不会自动把
UserController映射到user.php，它依赖 PSR-4 的标准转换：\app\controller\UserController→app/controller/UserController.php - 解决办法只有两个：统一用 PascalCase 命名文件（
UserController.php），或在composer.json中手动配置 autoload 的 classmap（不推荐，增加维护成本）
开启调试模式下容易忽略的隐性陷阱
开发时开 APP_DEBUG = true，错误提示会掩盖真实加载路径问题——例如看到 method not exists，其实根源是控制器根本没加载成功，只是框架兜底返回了错误方法提示。
立即学习“PHP免费学习笔记（深入）”；
- 遇到 404 或方法不存在，先查日志里的
ClassNotFoundException，而不是直接去改控制器方法名 - 用
debug_backtrace()在app\common.php钩子里临时打印$request->path()和标准化后的结果，确认是否真的进了钩子 - Apache 的
mod_rewrite或 Nginx 的try_files配置若未正确转发 PATH_INFO，会导致$request->path()为空，上面的钩子就完全失效
大小写兼容本质是路径解析和文件系统之间的桥接问题，不是加个配置就能关掉的开关；真正要稳，得从 URL 输入、路由解析、命名空间声明、物理文件名四个环节保持一致。
