ThinkPHP在Linux上404的根源是文件系统区分大小写，导致路由匹配的控制器文件（如User.php）因URL与文件名大小写不一致而无法加载；需确保文件名、类名、命名空间严格一致，并正确配置Web服务器入口路径。
ThinkPHP 路由为什么在 Linux 上突然 404？
因为 Linux 文件系统默认区分大小写，而 ThinkPHP 的 URL 路由匹配会落到模块/控制器/操作的文件路径上。如果你用 index.php?s=Index/index 这种方式访问，可能没问题；但开启伪静态后走 public/index.php 入口，最终加载 app/controller/Index.php 时，如果请求 URL 是 /index 却对应了 Index.php 文件，而服务器实际找的是 index.php（小写），就直接 404。
- Windows/macOS 开发环境不报错，上线 Linux 就崩 —— 根源是文件系统差异，不是框架 bug
- ThinkPHP 6 默认使用「类名映射」：访问
/user/list→ 自动找UserController类 → 对应app/controller/User.php文件 - 控制器类名必须首字母大写（如
UserController），但文件名大小写必须和类名严格一致，否则 Linux 下加载失败 - 别指望
url_convert或路由规则能绕过这一层 —— 文件加载阶段早于路由解析
如何让 ThinkPHP 在 Linux 下忽略 URL 大小写？
不能靠“让框架自动转大小写”，得从入口和配置两层堵住问题源头。
- 确保所有控制器文件名与类名完全一致：
User.php里必须是class UserController，不能是usercontroller或Usercontroller - 在
config/app.php中设置'app_multi_module' => false（单模块模式下路径更可控） - 禁用自动多应用识别：把
app_namespace显式设为'app'，避免因命名空间推导出错导致文件路径拼错 - 伪静态规则（如 Nginx）不要做 URL 小写重写 —— 那会掩盖真实问题，且可能破坏带参数的 URL
Apache/Nginx 配置里最容易翻车的点
Web 服务器本身不处理 ThinkPHP 路由逻辑，但它决定哪个 PHP 文件被加载。一旦配置不当，大小写问题会提前爆发。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- Apache 的
.htaccess里别用RewriteMap做大小写转换 —— 没必要，还容易引入编码问题 - Nginx 的
try_files必须指向正确的入口：try_files $uri $uri/ /index.php?$query_string;，注意不是/public/index.php（除非你把 root 设在 public 下） - 如果 root 指向的是项目根目录（非 public），那么
location ~ \.php$的fastcgi_param SCRIPT_FILENAME必须拼对路径，漏掉public/就会导致加载到错误的index.php - 确认
fastcgi_param PATH_INFO设置正确，ThinkPHP 依赖它解析 PATH_INFO 模式路由，设错会导致$_SERVER['PATH_INFO']为空或乱码
调试时看哪几个关键变量？
别猜，直接打印运行时上下文，快速定位是路由没匹配、还是文件根本没加载。
立即学习“PHP免费学习笔记（深入）”；
- 在
public/index.php最开头加var_dump($_SERVER['REQUEST_URI'], $_SERVER['PATH_INFO'] ?? '', $GLOBALS['_GET']['s'] ?? '');die; - 检查
App::routeCheck()返回值，看是否进入路由匹配流程；如果返回空数组，说明连路由都没走到，问题出在入口或 Web 服务器转发 - 打开
app_debug后，看日志里有没有ClassNotFoundException，如果有，重点查文件名和命名空间是否大小写一致 - 用
realpath(app_path() . 'controller/User.php')手动验证路径是否存在 —— Linux 下file_exists()对大小写敏感，这是最直接的判断依据
大小写问题本质是开发环境和生产环境的文件系统不一致，框架只是暴露了这个差异。改代码比改服务器配置更可靠，也更容易被团队成员理解。
