根本原因是强制路由开启后所有请求均需匹配路由规则，而静态资源路径未被识别为静态文件导致404；解决方案是在route/app.php顶部用Route::alias()映射静态路径或用Route::rule()显式匹配后缀并关闭ext补全。
ThinkPHP 强制路由开启后 public 目录下静态资源 404 的根本原因
强制路由（'url_route_must' => true）会让 ThinkPHP 拦截所有请求，只放行匹配到路由规则的 URL；而默认情况下，public/static、public/js、public/css 这类路径不会被自动识别为静态资源——它们也被当成“需要路由匹配”的动态请求，结果找不到对应路由就直接 404。
绕过路由检查：在 route/app.php 中添加静态资源路径别名
不是改 Web 服务器配置，也不是关掉强制路由，而是用 ThinkPHP 自身的「路由别名」机制告诉框架：“这些路径不用走路由逻辑，直接映射到文件系统”。
-
Route::alias('static', 'static')：把/static/xxx映射到public/static/xxx -
Route::alias('js', 'js')和Route::alias('css', 'css')同理 - 别名必须写在
route/app.php的最顶部（早于其他路由注册），否则可能被后续规则覆盖 - 注意路径大小写：Windows 下不敏感，Linux 下严格区分，建议统一小写
更稳妥的做法：用 Route::rule() 显式放行带扩展名的请求
别名方式对目录结构有隐含依赖；如果项目用了 CDN 或动静分离部署，推荐显式匹配后缀，控制粒度更细。
Route::rule(':path^.*\.(js|css|png|jpg|gif|svg|woff2|ttf)$', 'static/:path', 'GET', ['ext' => ''])->pattern(['path' => '\S+'])- 这个规则会匹配任意以指定后缀结尾的 URL，并原样转发到
public对应路径 -
['ext' => '']是关键：关闭 URL 后缀自动补全，否则/a.js可能被误判成/a.js.html - 该规则要放在所有模块路由之前，否则会被
Route::get(':id','index/index/read')类规则提前捕获
验证与常见踩坑点
改完路由后别急着刷新页面，先确认几件事：
立即学习“PHP免费学习笔记（深入）”；
- 清除
runtime/cache/下所有缓存文件，否则旧路由规则仍生效 - 访问
/static/test.png时，浏览器开发者工具 Network 面板看状态码是否变成 200，同时 Response Headers 中X-Powered-By应为 ThinkPHP（说明没被 Web 服务器直发） - 如果用了 Nginx，确保没有
location ~* \.(js|css|png)$ { try_files $uri =404; }这类规则干扰——它会绕过 PHP，导致路由配置失效 - 别在
.env里设APP_DEBUG=false后调试：错误被静默吞掉，404 页面不报具体原因
真正麻烦的不是写哪条路由，而是你不确定请求到底被谁处理了——Web 服务器？ThinkPHP 路由？还是中间件？查清链路比堆配置重要得多。
