ThinkPHP8上线后QPS低、CPU空转、偶发502的核心原因是OPcache未预热与FPM进程模型失配；需确认OPcache启用、配置合理参数、编写preload.php预热关键文件，并将FPM设为dynamic模式，调优pm相关参数。
ThinkPHP8项目在上线后遭遇QPS上不去、CPU空转、页面偶发502的问题，核心瓶颈往往不在代码逻辑，而在OPcache未预热与FPM进程模型失配——这两个配置项不调优，再多的SQL优化和缓存策略都只是隔靴搔痒。
确认OPcache已加载且FPM模式生效
这一步不能跳过，ThinkPHP8依赖大量动态类加载与反射，若OPcache未真正加载，后续所有预热动作都无效。执行php -m | grep opcache，终端必须输出opcache；若无输出，说明扩展未启用或PHP版本低于8.0（TP8最低要求PHP8.0）。
接着运行php --ini，记下Loaded Configuration File路径，这是你唯一要编辑的php.ini文件。【注意：FPM与CLI配置完全独立，改错文件等于白改】
打开该php.ini，确认存在以下两行且未被注释：
立即学习“PHP免费学习笔记（深入）”；
zend_extension=opcache.soopcache.enable=1
保存后，执行sudo systemctl reload php*-fpm（不是restart），再访问phpinfo()页面，确认“Opcode Caching”显示Enabled且“OPcache Support”为Enabled。
设置OPcache核心参数并启用预热
默认配置对ThinkPHP8严重不足，尤其max_accelerated_files常卡在4000，而一个标准TP8+Composer项目实际PHP文件超12000个，缓存命中率必然暴跌。
在php.ini的[opcache]区块中，将以下参数设为生产环境推荐值：
opcache.memory_consumption=256opcache.max_accelerated_files=20000opcache.validate_timestamps=0opcache.fast_shutdown=1opcache.revalidate_freq=0opcache.interned_strings_buffer=16
重启php-fpm后，立即执行预热脚本——这不是可选项。创建/var/www/tp8/preload.php，内容为：
<?php<br> opcache_compile_file(BASE_PATH . '/thinkphp/base.php');<br> opcache_compile_file(BASE_PATH . '/thinkphp/library/think/App.php');<br> opcache_compile_file(BASE_PATH . '/thinkphp/library/think/Container.php');<br> // 补全你项目中高频加载的控制器、中间件、服务提供者路径<br> ?>
然后在php.ini中添加：opcache.preload=/var/www/tp8/preload.php。该脚本会在FPM主进程启动时一次性编译并载入内存，worker进程直接复用，彻底规避首次请求冷启动。
FPM进程模型与关键参数重配
ThinkPHP8是常驻内存型框架，FPM默认静态模式（static）或保守动态模式（dynamic）会严重浪费资源。必须切换为高并发适配的动态伸缩模型。
编辑/etc/php/*/fpm/pool.d/www.conf，按以下顺序调整：
第一步：pm = dynamic
第二步：pm.max_children = 300（按单worker平均内存12MB反推：300×12MB≈3.6GB，留足系统余量）
第三步：pm.start_servers = 100（避免冷启动时fork延迟）
第四步：pm.min_spare_servers = 60，pm.max_spare_servers = 150（保证空闲池足够应对突发流量）
第五步：pm.max_requests = 1000（防长期运行内存泄漏，TP8中常见于闭包或静态变量累积）
第六步：request_terminate_timeout = 30s（防慢脚本阻塞整个worker）
改完立刻执行sudo systemctl reload php*-fpm，不要用restart——reload能平滑切换worker，零请求丢失。
验证预热效果与缓存命中率
部署完成后，用curl快速发起10次请求：
for i in {1..10}; do curl -o /dev/null -s -w "%{http_code}\n" http://localhost/; done
观察是否全部返回200且无502。然后执行：
php -r "print_r(opcache_get_status()['opcache_statistics']);"
重点检查三项：hits应远大于misses，cache_full必须为false，oom_restarts必须为0。若hits / (hits + misses)低于0.95，说明预热不充分或max_accelerated_files仍不足，需补全preload.php中的文件路径。
