ThinkPHP 8部署到AI服务器必须关闭调试模式、启用数据库长连接与连接池隔离、分离静态资源与API路由、正确解析JSON请求体及校验规则，否则模型服务调用时会触发调试中间件导致HTML混入或SQL泄露。
将ThinkPHP 8部署到AI服务器不是简单复制代码，必须切断调试输出、隔离数据库连接池、绕过public/index.php完整生命周期、正确解析JSON请求体——否则模型服务调用TP接口时会意外触发调试中间件，导致响应混入HTML片段或SQL泄露。
关闭调试模式并禁用错误显示
打开项目根目录下的.env文件，将APP_DEBUG=true改为APP_DEBUG=false。
这一步不可跳过：AI服务器常通过FastAPI或Traefik反向代理调用TP接口，若X-Debug: 1头被透传，TP会激活调试中间件，哪怕.env已关，PHP配置未同步也会导致500响应体夹带HTML堆栈。
同步修改PHP配置：确保display_errors=Off且log_errors=On，日志路径需指向runtime/log/，检查该目录下是否有sql.log或error.log生成——没有日志即说明debug仍处于开启状态。
立即学习“PHP免费学习笔记（深入）”；
执行curl测试：curl -I http://your-tp-api/v1/predict，响应头中不能出现X-Powered-By: ThinkPHP，该header仅在debug=true时默认输出。
启用数据库长连接与连接池隔离
编辑config/database.php，为AI专用数据源启用持久连接：
在对应数据库配置项中添加：'persistent' => true和'params' => [PDO::ATTR_PERSISTENT => true]。
不要复用主库连接池给向量检索服务（如Milvus/Pinecone），必须单独定义vector_db数据源，并在代码中显式调用Db::connect('vector_db')。
若使用Redis做缓存穿透防护，cache.handler严禁设为File——AI服务器多进程下文件锁极易冲突，应改用Redis或SwooleTable。
分离静态资源与API路由
第一步：在Nginx配置中，将所有以/api/、/v1/、/predict等特征开头的请求直接转发至PHP-FPM，不经过public/index.php入口。
第二步：在nginx.conf中添加location块，匹配API路径后使用fastcgi_pass直连PHP-FPM socket，跳过框架路由解析与容器初始化。
第三步：确认TP路由配置中，API模块不依赖public/index.php的全局加载逻辑，所有中间件、验证器、模型加载均需按需注入而非全量加载。
这一步操作起来很简单，直接把Nginx的location规则写进去就行。但若仍走index.php入口，每次推理请求都要加载全部框架——对毫秒级延迟要求的AI链路是致命浪费。
正确处理JSON请求与校验规则
方法一：在全局中间件中强制解析原始请求体
创建app/middleware/JsonRequest.php，在handle()中调用input()->getRawInput()并用json_decode()解析，再挂载到$request->data属性。
方法二：覆盖默认验证器行为
在app/validate/BaseValidate.php中重写getData()方法，优先读取$this->request->data而非$this->request->param()，避免POST表单解析逻辑干扰JSON字段映射。
注意：ThinkPHP默认对Content-Type: application/json请求只解析顶层键值，嵌套对象或数组会丢失——必须手动触发json_decode($raw, true)并递归合并。
