php接口不生效主因是nginx与php-fpm链路未对齐：需验证php-fpm进程与监听方式（tcp/socket）、确认nginx配置真实加载（尤其docker中default.conf干扰）、严格校准root/alias路径与script_filename拼接，并闭环执行nginx -t与reload，最后查error.log定位connect失败、路径错误或权限问题。
确认 PHP-FPM 服务真实就绪
光看systemctl status php8.1-fpm不够，得验证进程和监听是否匹配：
- 运行
ps aux | grep fpm，确认有类似php-fpm: master process的主进程 - 查监听方式：
sudo ss -tulpn | grep ':9000\|php.*sock，确认实际监听的是 TCP（127.0.0.1:9000）还是 Unix socket（如/run/php/php8.1-fpm.sock） - 若用 socket，检查文件是否存在且可读：
ls -l /run/php/php8.1-fpm.sock，权限应为srw-rw----，所属用户组需包含 nginx 用户（如www-data或nginx）
核对 Nginx 配置是否被真正加载
Docker 或常规部署中，配置常因路径、覆盖或加载顺序失效：
- 执行
nginx -T | grep -A 5 "location ~ \.php"，直接看最终生效的配置块内容，而非你编辑的文件 - Docker 环境重点检查：
/etc/nginx/conf.d/下是否残留default.conf？它会按字母序优先接管请求，导致你的app.conf被忽略 - 解决方法二选一：删掉 default.conf（
RUN rm -f /etc/nginx/conf.d/default.conf），或把你的配置重命名为 default.conf 直接覆盖
检查 location 和 root/alias 的路径一致性
SCRIPT_FILENAME 传错路径是“No input file specified”错误的根源：
- 确保
server或location块里明确定义了root，例如root /var/www/myapp/public; -
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;中的$document_root必须等于上面root的值；若用了alias，就不能依赖$document_root，得写死路径 - ThinkPHP/Laravel 等框架必须指向
public目录，不能指向项目根目录；否则index.php找不到，或路由入口失效
验证与重启动作必须闭环
改完不等于生效，中间漏一步就白调：
- 每次修改后先执行
nginx -t，确认语法无误 - 用
nginx -s reload重载（不是restart），避免中断连接 - 若仍无效，查
/var/log/nginx/error.log，搜索connect() failed（连不上 PHP-FPM）、No input file specified（路径错）、Permission denied（权限或 SELinux 限制）等关键词 - 临时加一行
fastcgi_param SCRIPT_FILENAME /var/www/myapp/public/index.php;测试是否路径问题，能跑通再回归动态拼接
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
