Nginx-PHP-FPM 7.1 Docker容器访问子目录PHP文件响应延迟求助

算力阿峰

2026-5-20

排查Nginx+PHP-FPM Docker环境中子目录PHP文件延迟问题

兄弟，折腾一天还没搞定这问题真的够闹心的！我之前在类似的Docker架构里也碰到过子目录PHP请求延迟的坑，结合你的情况，给你几个针对性的排查方向，应该能帮你找到问题所在：

核对Nginx配置里的路径映射是否正确
绝大多数时候子目录请求慢，都是Nginx给PHP-FPM传的文件路径出问题了，导致PHP在找文件的时候走了弯路甚至触发了不必要的权限校验。你得确保不管是根目录还是子目录，SCRIPT_FILENAME参数都精准指向共享卷在PHP-FPM容器里的真实路径。
举个正确的配置示例，你可以对照着检查自己的Nginx配置：
```
location ~ \.php$ {
    root /var/www/html; # 这个路径必须和PHP-FPM容器内的网站根目录完全一致
    fastcgi_pass php-fpm:9000; # 这里的php-fpm是你的PHP容器服务名/IP
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}
```
你可以在Nginx容器里用curl -v http://localhost/子目录/xxx.php测试，同时查看PHP-FPM的日志（docker logs <你的PHP-FPM容器名>），如果日志里有文件找不到、路径错误的记录，那这就是延迟的根源。
检查共享卷的权限与挂载性能
Docker共享卷的挂载方式和权限很容易踩坑：
- 先进入PHP-FPM容器（docker exec -it <你的PHP-FPM容器名> bash），执行ls -l /var/www/html/你的子目录，确认PHP-FPM运行的用户（一般是www-data）有读取该目录下文件的权限，权限不对会导致PHP反复尝试访问触发延迟。
- 如果是用的宿主机bind mount（直接挂载宿主机目录），尤其是在Windows WSL2或者MacOS环境下，宿主机的文件系统性能可能会拖累子目录的文件读取速度，你可以尝试把应用文件复制到Docker volume里再测试，看延迟是否消失。
- 另外，PHP的realpath_cache可能没缓存子目录的路径，导致每次请求都要重新解析路径。你可以修改php.ini，把realpath_cache_size调到16k以上，realpath_cache_ttl设为120，然后重启PHP-FPM容器试试。
排查PHP-FPM的进程池配置
虽然根目录请求正常，但子目录的应用可能触发了不同的进程调度逻辑。你可以打开PHP-FPM的www.conf配置文件，检查pm.max_children、pm.start_servers这些参数，确保进程池有足够的空闲进程来处理子目录的请求。如果进程池满了，新请求就得排队，自然会延迟。
你可以用php-fpm7.1 -t检查配置是否合法，没问题的话重启PHP-FPM容器。
检查Nginx的子目录特殊配置
看看你的Nginx配置里有没有针对子目录的特殊规则，比如额外的rewrite、auth验证、或者未正确配置的缓存模块，这些都可能导致子目录请求变慢。你可以临时注释掉这些特殊配置，测试请求是否恢复正常，逐步排查出问题点。

内容的提问来源于stack exchange，提问作者fFathead