thinkphp二级域名配置失败主因是解析、绑定、路由、跨域、环境五环节断链：先用dig/nslookup验dns生效；再查web服务器域名绑定与根目录；接着确认框架子域名部署及映射规则；然后动态配置cors避免credentials拦截；最后处理多语言识别与https证书覆盖。
ThinkPHP 配置二级域名失败，多数不是框架本身的问题，而是“解析→绑定→路由→语言/跨域→环境”五个环节中某一处断开。下面直击最常踩的坑，不绕弯、不讲理论，只说怎么查、怎么改。
一、DNS没真正生效，请求根本到不了服务器
你在域名后台填了 api.example.com → 123.45.67.89，但用户访问还是 404 或跳首页——大概率 DNS 还没生效。
- 用 dig api.example.com +short（Mac/Linux）或 nslookup api.example.com（Windows）查返回 IP，必须是你服务器的真实公网 IP
- 别信“已添加”的后台提示，要实测；TTL 高时等 1–2 小时才全网更新，调试期建议设成 60 秒
- 如果套了 CDN（如 Cloudflare），确认是 DNS only 模式（灰色云），否则流量被 CDN 拦截，根本进不了你的 ThinkPHP
二、Web 服务器没正确绑定或转发
即使 DNS 正确，宝塔/Nginx/Apache 若没把 api.example.com 的请求导向对应目录，一样 404。
- 宝塔：添加站点时，「域名」栏必须填完整二级域名（如 api.example.com），不能只填 api；根目录路径要真实存在且权限正确（如 /www/wwwroot/api.example.com）
- Nginx：location 块必须显式匹配子域名路径，例如 server_name api.example.com;，并确保 root 指向 public 目录，不是项目根目录
- Apache：检查 .htaccess 是否在 public/ 下，且虚拟主机配置中 AllowOverride All 已开启
三、框架路由没识别子域名，还在走默认模块
访问 admin.example.com 却打开首页或报错 Route not found，说明 ThinkPHP 没把该域名映射到 admin 模块。
- 确认 config/app.php 中已开启：'app_sub_domain_deploy' => true
- 配置映射规则：'app_sub_domain_rules' => ['admin' => 'admin', 'api' => 'api']；若主域名是 example.com.cn，还要加 'app_domain_suffix' => 'com.cn'
- 别和 Route::domain() 混用——二者选其一；若用 Route::domain，必须在 route/route.php 中写明：Route::domain('admin', 'admin'); 并开启 'url_domain_deploy' => true
四、带 Cookie 的跨域请求被浏览器拦截
前端用了 credentials: 'include'，后端却还配 Access-Control-Allow-Origin: *，浏览器直接拒绝响应。
- CORS 中间件里不能写死 *，要动态读取 $request->header('origin')，再比对白名单数组（如 ['https://admin.example.com', 'https://app.example.com']）
- 匹配成功后，同时设置：Access-Control-Allow-Origin → 当前 origin，且 Access-Control-Allow-Credentials → true
- 中间件必须全局注册、放在最前面（app/middleware.php 第一位），确保在 Session/Auth 之前执行
五、多语言或 HTTPS 导致页面“看似正常实则失效”
访问 en.example.com 文字全是中文，或 HTTPS 下提示证书错误——表面能打开，实际关键功能挂了。
- 语言问题：关闭 allow_url_lang（防止 ?lang=xxx 覆盖域名判断），在全局中间件首行用 parse_url($_SERVER['HTTP_HOST'], PHP_URL_HOST) 提取纯净域名，再查配置数组映射语言码，最后调用 Lang::setLang()
- HTTPS 问题：Let’s Encrypt 默认证书不包含二级域名，需在宝塔 SSL 页面手动扩展，填入 api.example.com、admin.example.com 等；证书路径也要核对 Nginx 配置是否指向最新 fullchain.pem
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
