Nginx运行ThinkPHP需正确配置PHP-FPM对接、PATH_INFO传递、入口路径、超时参数及变量解析：一、确认PHP-FPM状态与监听地址一致；二、用正则location和fastcgi_split_path_info分离脚本与路径参数；三、root指向public目录并启用伪静态；四、同步PHP-FPM与Nginx超时设置；五、验证SCRIPT_FILENAME与PATH_INFO实际值。
当Nginx无法正确执行ThinkPHP应用的PHP脚本，出现502 Bad Gateway、No input file specified或直接输出PHP源码时，核心问题在于Nginx与PHP-FPM的对接配置未适配ThinkPHP的入口机制与路由解析逻辑。以下是解决此问题的步骤：
一、确认PHP-FPM服务状态并校准监听地址
PHP-FPM必须处于运行状态，且其监听地址（Unix socket或TCP端口）需与Nginx中fastcgi_pass严格一致；否则Nginx无法建立FastCGI连接，直接触发502错误。同时需确保socket文件权限允许Nginx worker进程读写。
1、执行systemctl status php*-fpm查看实际运行的服务名（如php8.1-fpm），避免仅依赖服务名猜测版本。
2、使用sudo ps aux | grep fpm确认PHP-FPM主进程及worker进程真实存在，排除因配置错误导致进程自动退出的情况。
立即学习“PHP免费学习笔记（深入）”；
3、打开PHP-FPM Pool配置文件（通常为/etc/php/8.1/fpm/pool.d/www.conf），检查listen =行值，确认是Unix socket路径（如/run/php/php8.1-fpm.sock）还是TCP地址（如127.0.0.1:9000）。
4、若为Unix socket，执行ls -l /run/php/php8.1-fpm.sock验证文件存在且属组为www-data（或Nginx运行用户所属组），权限为srw-rw----；若不符，修改www.conf中listen.owner与listen.group并重启PHP-FPM。
二、配置Nginx location块以兼容ThinkPHP入口与PATH_INFO
ThinkPHP默认采用单一入口index.php，并通过PATH_INFO或QUERY_STRING传递路由参数。Nginx必须正确拆分请求URI，将脚本路径传给SCRIPT_FILENAME，同时将路径参数注入PATH_INFO，否则会导致路由失效或“No input file specified”错误。
1、在server块内定义location匹配规则，推荐使用支持PATH_INFO提取的正则：location ~ ^(.+\.php)(/.*)?$，该模式可覆盖/index.php/admin/login等格式。
2、在该location中添加fastcgi_split_path_info ^(.+\.php)(/.*)$;指令，使Nginx能分离出$fastcgi_script_name与$fastcgi_path_info。
3、设置关键参数：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;确保指向真实PHP文件；fastcgi_param PATH_INFO $fastcgi_path_info;供ThinkPHP读取路由。
4、显式指定fastcgi_index为index.php，并包含标准参数：include fastcgi_params;，避免因遗漏SCRIPT_NAME等变量引发兼容问题。
三、启用ThinkPHP伪静态并确保root路径准确
ThinkPHP的URL重写依赖Nginx对非PHP资源的静态处理能力及对PHP入口的统一转发。若root路径配置错误或未启用重写，将导致静态资源404或路由跳转失败。
1、确认server块中root指令指向ThinkPHP项目的public目录（如/var/www/example.com/public），而非项目根目录，防止敏感文件泄露。
2、在location /块中添加伪静态规则，适配ThinkPHP默认URL模式：if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }。
3、若使用ThinkPHP 6+的pathinfo模式，需确保该rewrite规则位于location /内，且不与location ~ \.php$冲突；必要时将PHP处理块移至最外层server下，避免嵌套location覆盖。
4、验证Nginx配置语法：sudo nginx -t，成功后重载：sudo systemctl reload nginx。
四、调整PHP-FPM Pool超时与权限参数以匹配ThinkPHP行为
ThinkPHP在调试模式、大文件上传或数据库长查询时易触发超时，而默认PHP-FPM request_terminate_timeout与Nginx fastcgi_read_timeout不一致将导致504 Gateway Timeout；此外，opcache启用不当可能缓存错误的PATH_INFO解析结果。
1、编辑PHP-FPM Pool配置（如/etc/php/8.1/fpm/pool.d/www.conf），设置request_terminate_timeout = 300（单位秒），避免脚本被强制终止。
2、在Nginx PHP location块中同步设置fastcgi_read_timeout 300;，确保两边超时阈值一致。
3、检查security.limit_extensions = .php .php3 .php4 .php5 .php7 .php8是否包含当前使用的扩展名，防止ThinkPHP入口文件被拒绝执行。
4、若启用opcache，确认opcache.revalidate_freq = 2等参数合理，避免因缓存未及时更新导致路由解析异常；必要时临时禁用opcache测试。
五、验证PATH_INFO传递与SCRIPT_FILENAME生成逻辑
部分Nginx版本或自定义配置中，$fastcgi_script_name可能被rewrite规则篡改，或$document_root未正确继承，导致SCRIPT_FILENAME拼接错误。需手动验证变量实际值，定位路径构造偏差。
1、在PHP-FPM配置中临时启用环境变量透传：catch_workers_output = yes，并在www.conf中添加php_admin_value[error_log] = /var/log/php-fpm-thinkphp.log。
2、在ThinkPHP入口index.php顶部插入调试代码：file_put_contents('/tmp/nginx_vars.log', "SCRIPT_FILENAME: ".$_SERVER['SCRIPT_FILENAME']."\nPATH_INFO: ".$_SERVER['PATH_INFO']."\n", FILE_APPEND);。
3、访问一个带PATH_INFO的URL（如/example/index.php/admin/user），检查/tmp/nginx_vars.log中记录的路径是否指向真实文件（如/var/www/example.com/public/index.php）且PATH_INFO为/admin/user。
4、若SCRIPT_FILENAME错误，回溯Nginx配置中$document_root来源：确认root在server或location中明确定义，且未被alias指令覆盖；若使用alias，SCRIPT_FILENAME必须硬编码路径，不可依赖$document_root。
