ThinkPHP超时本质是Web请求生命周期被中止，应将长任务移出HTTP链路；首选自定义指令+nohup后台执行，避免宝塔计划任务重复触发，临时调高超时仅为过渡方案。
ThinkPHP执行超时不是代码本身卡住，而是Web请求生命周期被服务器或PHP强行中止。解决的关键是把“不能等”的任务移出HTTP请求链路，而不是调高超时时间。
识别真正超时原因
先确认是不是真超时：查看Nginx/Apache错误日志里的504 Gateway Timeout或PHP错误日志中的Maximum execution time exceeded。前者是反向代理超时（通常30–60秒），后者是PHP脚本执行超时（默认30秒）。两者都说明当前任务不该走Web请求流程。
用自定义指令替代表单提交
把耗时操作（如拉取万条API数据、批量导入Excel、生成大报表）从控制器方法里剥离，封装成ThinkPHP自定义指令：
- 在
app/command下新建类，继承think\console\Command - 重写
configure()和handle()，把原业务逻辑搬进去 - 通过
php think your:command --arg=value直接运行，不经过Web服务器
这样就绕开了所有HTTP层限制，执行时间只受服务器资源约束。
后台守护运行（nohup + screen）
指令写好后，别在SSH里直接敲命令——断开连接进程就终止。要用后台方式启动：
-
nohup php think your:command > /tmp/your.log 2>&1 &—— 最简可靠方案 - 加
screen -S import再运行指令，可随时screen -r import回看进度 - 避免用宝塔“计划任务”跑一次性长任务，它会重复触发、状态不可控
必要时补上超时兜底配置
如果某些轻量任务仍需走Web请求（比如上传后立即处理几百条数据），可临时放宽限制，但仅限可控场景：
- 在对应控制器方法开头加
set_time_limit(120)（单位秒） - Nginx配置中调整
fastcgi_read_timeout 120; - PHP-FPM池配置中设
request_terminate_timeout = 120s - 注意：这些只是过渡手段，不解决根本问题，上线前必须回归指令+后台模式
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
