TP8.0路由路径默认区分大小写，需通过单条规则option(['case_sensitive'=>false])或全局Route::setDomainCase(false)关闭；推荐使用NormalizePath中间件统一转小写并重写PATH_INFO，确保全路由匹配一致。
ThinkPHP 5.1 默认路由不区分大小写（底层做了 strtolower 预处理），而 TP8.0 完全取消了这一行为——路由路径匹配默认严格区分大小写，这是设计变更，不是 bug。迁移后若出现 /Index/Index 404 而 /index/index 正常，问题就出在这里。
路由路径大小写敏感的控制方式
TP8.0 提供两种粒度的开关，但都只作用于 URL 路径段（如 /hello/world 中的 hello 和 world），不影响控制器类名或方法名：
-
单条规则关闭：
Route::get('hello/:name', 'index/hello')->option(['case_sensitive' => false]); -
全局关闭（仅 TP6.1+ 及 TP8.0 支持）：
在app/route/app.php开头调用：Route::setDomainCase(false);
⚠️ 注意：case_sensitive => false 不会让 /INDEX/HELLO 自动映射到 IndexController::hello()。控制器和方法仍按 PHP 原生规则加载——类名必须首字母大写（IndexController），方法名必须小写（hello）。路径大小写忽略 ≠ 类/方法名自动转换。
更可靠的做法：统一转小写中间件
依赖 case_sensitive 容易漏配（尤其多模块、多路由文件时）。推荐在请求入口做标准化：
新建中间件 app/middleware/NormalizePath.php：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
<?php declare(strict_types=1);
namespace app\middleware;
use think\Request;
use think\Response;
class NormalizePath
{
public function handle(Request $request, \Closure $next): Response
{
$path = $request->path();
if ($path && !str_starts_with($path, '/')) {
$path = '/' . ltrim($path, '/');
}
$lowerPath = strtolower($path);
// 重写 PATH_INFO，确保后续路由解析基于小写路径
$_SERVER['PATH_INFO'] = $lowerPath;
$request->path($lowerPath);
return $next($request);
}
}
然后在 app/middleware.php 中将其置于最前：
return [
\app\middleware\NormalizePath::class,
// 其他中间件...
];
这样所有路由（包括注解路由、子应用路由、多语言路由）都会基于小写路径匹配，无需每条规则重复配置 case_sensitive。
多应用下特别注意
若用了 topthink/think-multi-app，每个子应用（如 app/admin/）的路由也需遵循同一逻辑。Route::import('admin', 'admin') 导入的路由同样受 case_sensitive 控制，但中间件方式天然覆盖全部子应用，更省心。
Web 服务器层补充（Linux 生产环境必查）
Nginx/Apache 对路径本身大小写敏感。比如 /Index/Hello 和 /index/hello 是两个不同路径，即使框架开了 case_sensitive => false，Web 服务器也可能直接返回 404（根本未转发给 PHP）。确认 Nginx 配置中 location / 块正确转发所有非静态资源到 index.php，且 fastcgi_split_path_info 已启用，否则 $_SERVER['PATH_INFO'] 为空，中间件也无从生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
