ThinkPHP部署后接口报404主因是Web服务器未正确指向public目录或伪静态未生效：Nginx需root指向/public并配置try_files；Apache需启用mod_rewrite且AllowOverride All；同时须清空runtime/route缓存并重建。
ThinkPHP部署后接口报错，多数不是代码本身问题，而是环境、配置、路由或请求约定不匹配导致的。本地能跑，线上崩，基本就卡在这几处。
检查Nginx/Apache是否正确指向入口文件
ThinkPHP（尤其是TP6/TP8）要求Web服务器根目录必须指向public目录，而非项目根目录。否则所有请求无法命中public/index.php，直接返回404。
- Nginx配置中root指令必须是/path/to/your/project/public
- 同时需启用URL重写，确保非静态资源全部交由index.php处理：
try_files $uri $uri/ /index.php?$query_string; - Apache用户请确认.htaccess已启用，且AllowOverride All已配置在对应目录块中
验证路由缓存与配置是否生效
部署后常见全站404或500，很可能是路由缓存损坏或未生成。ThinkPHP会把路由规则编译为PHP文件缓存，一旦部署时权限不对、目录不可写或缓存残留，就会导致路由无法识别。
- 手动清空runtime/route目录（保留目录结构即可）
- 执行命令重建缓存：php think route:clear（TP6）或php think optimize:route（TP8）
- 检查route/app.php中分组前缀（如adminapi）是否与实际请求URL一致，比如/adminapi/login不能误写成/api/login
确认请求头与参数格式是否符合后端预期
Postman或前端调用失败，常因一个细节不匹配：比如Token放错位置、Content-Type没设对、或漏了Accept头。
立即学习“PHP免费学习笔记（深入）”；
- 带鉴权的接口，Authorization头必须选“Bearer Token”类型填写，不要手动拼Bearer xxx——Postman会自动加前缀，重复会导致401
- 传JSON数据，Body选raw → JSON，并手动设置Header：Content-Type: application/json
- TP6/TP8默认要求Accept: application/json才能返回JSON错误；否则可能返回HTML错误页，造成前端解析失败
排查HTTPS和代理环境下的协议识别问题
若项目部署在SLB、CDN或Nginx反向代理后，$request->isSsl()可能始终返回false，导致强制跳转或权限拦截异常。
- 在config/app.php中开启代理信任：'trust_proxy' => true
- 补充可信IP段：'trust_proxies' => ['10.0.0.0/8', '127.0.0.1']（按你实际回源网段调整）
- 调试时可在控制器加dump($request->header('x-forwarded-proto'), $_SERVER['HTTPS']);，确认协议头是否透传到位
