根本原因是强制路由开启后所有请求均需匹配路由规则，而静态资源路径未被识别为静态文件导致404；解决方案是在route/app.php顶部用Route::alias()映射静态路径或用Route::rule()显式匹配后缀并关闭ext补全。
强制路由开启后，public/static、public/js、public/css 下的文件访问直接 404，不是框架坏了，也不是文件丢了，是 ThinkPHP 把这些路径当成了需要路由匹配的动态请求——而你没写对应路由，自然就 404。
为什么 Route::alias() 必须放在 route/app.php 最顶部
ThinkPHP 路由注册是顺序执行的，一旦某条规则匹配成功，后续规则（包括 alias）就不会再检查。Route::alias('static', 'static') 这类映射本质是内部注册了一条「路径前缀 → 目录」的快捷路由；如果它被写在 Route::get('/user/:id', ...) 后面，而用户恰好访问 /static/logo.png，框架会先拿这个 URL 去匹配 /user/:id —— 显然不匹配，但此时已错过 alias 规则的注册时机（因为 alias 还没执行），最终 fallback 到 404。
必须确保：
-
Route::alias()出现在route/app.php文件最开头，任何Route::get、Route::post或Route::import()之前 - 别名值（第二个参数）必须与
public/下真实目录名完全一致，大小写敏感：Linux 上Route::alias('JS', 'js')会导致/JS/main.js404 - 别名 key（第一个参数）就是 URL 中的路径前缀，
Route::alias('assets', 'static')对应访问/assets/icon.svg
Route::rule() 匹配后缀比 alias 更可控
alias 依赖目录结构硬编码，一旦你把 JS 放到 CDN 或用构建工具输出到 public/dist/，alias 就得全改。Route::rule() 直接按文件扩展名放行，不关心路径层级，更适合现代前端部署。
立即学习“PHP免费学习笔记（深入）”；
这条规则要加在 route/app.php 顶部，且必须早于所有模块路由：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
Route::rule(':path^.*\.(js|css|png|jpg|gif|svg|woff2|ttf|webp)$', 'static/:path', 'GET', ['ext' => ''])->pattern(['path' => '\S+']);关键点：
-
['ext' => '']是必须的：关闭 ThinkPHP 自动补全 URL 后缀（否则/a.js可能被当成/a.js.html处理） -
pattern(['path' => '\S+'])防止空格或换行符混入路径，避免解析失败 - 正则里漏掉你实际用的后缀（比如用了
.webp却没加进去），对应资源仍会 404 - 该规则只处理
GET请求，不影响 POST/PUT 等接口路由
改完路由不生效？先清缓存再验证
ThinkPHP 路由规则会被编译缓存，route/app.php 修改后不清理，旧规则还在 runtime 里跑着。
执行这三步再测试：
- 删掉
runtime/cache/目录下所有文件（别只删部分，全清） - 访问
/static/test.png，打开浏览器 Network 面板看状态码：要是 200，再看 Response Headers 里的X-Powered-By是否为ThinkPHP（说明是 PHP 处理的，不是 Web 服务器直发） - 如果仍是 404，检查是否启用了
APP_DEBUG=false：关掉调试模式后，ThinkPHP 会静默吞掉路由不匹配错误，你根本看不到提示
Nginx/Apache 配置可能绕过路由逻辑
即使 ThinkPHP 路由写对了，Web 服务器也可能提前截胡请求——比如 Nginx 的 location ~* \.(js|css|png)$ 规则里写了 try_files $uri =404;，它会直接查文件系统，根本不会把请求交给 index.php，你的所有路由配置都白搭。
排查方法：
- 临时注释掉 Nginx 配置中所有针对静态资源的
location块，只留兜底的location / { try_files $uri $uri/ /index.php?$query_string; } - Apache 用户检查
.htaccess是否存在干扰规则，或AllowOverride None导致重写失效 - 确认 Web 服务器的 DocumentRoot 指向的是
public/目录，而不是项目根目录——指向错会导致/static/根本找不到物理路径
真正麻烦的从来不是写哪条路由，而是你不知道这个请求到底被谁拦下了：是 Nginx 查文件失败？是 Apache 拒绝解析 .htaccess？还是 ThinkPHP 路由根本没加载？先确定处理链路，再逐段排除。
