thinkphp二级域名下静态资源404的根本原因是web服务器根目录未指向public、路径生成逻辑与转发规则不匹配；必须将nginx root/apache documentroot设为public目录，使用asset()函数生成路径，nginx静态资源需用alias精准映射，禁用__static__常量改用可配置的static_url()函数。
ThinkPHP 配置二级域名后静态资源加载失败，问题不在框架本身，而在于Web 服务器根目录指向、路径生成逻辑、Nginx/Apache 转发规则三者没对齐。常见表现是 CSS/JS 返回 404，但文件明明存在——本质是请求路径和物理路径不匹配。
Web 服务器必须指向 public 目录
这是最常被忽略的前提：ThinkPHP 的 Web 入口是 public/，不是项目根目录。若你把整个项目（含 app、config）直接丢进 Nginx 的 root，浏览器请求 /static/css/app.css 就会去查 /var/www/static/css/app.css，而真实路径是 /var/www/public/static/css/app.css。
- Nginx：确认
root指向的是项目public目录，例如root /var/www/myapp/public; - Apache：确保站点 DocumentRoot 是
/var/www/myapp/public，且.htaccess文件在该目录下 -
phpEnv 用户：在面板中将「网站目录」手动改为
D:\phpenv\www\myapp\public，改完必须重启服务
模板里别硬写 /static/，用 asset() 函数
__PUBLIC__ 和 __STATIC__ 是编译期常量，不会随二级域名或子目录自动变化；手写 <link href="/static/css/app.css"> 在二级域名下可能指向错误域名或缺失前缀。
- 正确写法：
<link href="%7B%7B%20asset('static/css/app.css')%20%7D%7D">——asset()自动拼接当前域名 + 当前部署上下文（支持子域名、子目录） - 路径参数不带
public/前缀，asset('assets/js/main.js')对应的是public/assets/js/main.js - Linux 服务器注意大小写：
Static/和static/是两个路径，404 很可能就卡在这儿
Nginx 下二级域名 + 静态资源 alias 必须精准匹配
即使 root 指向正确，若用了子目录部署（如 api.example.com 对应 /var/www/api/），Nginx 还需显式映射静态资源路径，否则会多拼一层。
- 错误配置：
location /static/ { root /var/www/api/public; }→ 请求/static/css/a.css会找/var/www/api/public/static/css/a.css（不存在） - 正确配置：
location ^~ /static/ { alias /var/www/api/public/static/; }→ 注意alias结尾斜杠必须与路径一致 - 若二级域名对应独立站点，建议每个子域名配独立 server 块，并在其中定义专属
location ^~ /static/
CDN 或多环境时，别依赖 __STATIC__
__STATIC__ 不读配置、不识别 CDN 域名，改了 config/app.php 里的 'static' 项也没用。
- 删掉所有
{:__STATIC__}，改用自定义函数，例如在common.php中定义：function static_url($path) { return config('cdn_domain', '') . '/' . ltrim($path, '/'); } - 在
.env中加CDN_DOMAIN=https://cdn.example.com - 模板中调用：
<link href="%7B%7B%20static_url('static/css/app.css')%20%7D%7D">
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
