配置 fastcgi_pass 的核心是让 Nginx 准确把 PHP 请求交给正在运行的 PHP-FPM 实例，两者地址必须完全一致，且权限、协议、路径三者匹配；不匹配直接导致 502 Bad Gateway，需检查 listen 值、fastcgi_pass 路径、socket 权限及配套参数 SCRIPT_FILENAME 等。
配置 fastcgi_pass 的核心是让 Nginx 准确把 PHP 请求交给正在运行的 PHP-FPM 实例，两者地址必须完全一致，且权限、协议、路径三者匹配。不匹配直接导致 502 Bad Gateway。
确认 PHP-FPM 实际监听地址
PHP-FPM 默认不监听 TCP 端口，而是用 Unix socket 文件（如 /run/php/php8.2-fpm.sock）。先查真实监听配置：
- 打开
/etc/php/8.2/fpm/pool.d/www.conf（版本号按你实际安装调整） - 找
listen =这一行，常见值有：listen = /run/php/php8.2-fpm.sock（Unix socket）listen = 127.0.0.1:9000（TCP） - 同时检查
listen.owner和listen.group，比如www-data，确保 Nginx worker 进程属于该组
在 Nginx server 块中写对 fastcgi_pass
位置必须在 location ~ \.php$ { ... } 内，且值要和上一步查到的 listen 完全一致：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 若 PHP-FPM 监听 socket：
fastcgi_pass unix:/run/php/php8.2-fpm.sock; - 若监听 TCP：
fastcgi_pass 127.0.0.1:9000; - 不要混用：写
unix:/tmp/xxx.sock但 PHP-FPM 实际监听的是127.0.0.1:9000，必然失败
配套必需参数不能少
fastcgi_pass 单独存在没用，必须配合以下关键项才能正确执行 PHP 文件：
立即学习“PHP免费学习笔记（深入）”；
-
include fastcgi_params;或更推荐的include snippets/fastcgi-php.conf;（Ubuntu/Debian 系统自带） -
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
注意不是写死路径，必须用变量动态拼出真实文件绝对路径 -
fastcgi_index index.php;（配合index指令使用）
验证与排错要点
改完配置别急着 reload，按顺序检查：
- 运行
sudo nginx -t确保语法无误 - 确认 PHP-FPM 服务已启动：
systemctl status php8.2-fpm - 检查 socket 文件是否存在、权限是否可读写：
ls -l /run/php/php8.2-fpm.sock（应为srw-rw----，属组匹配 Nginx） - 看错误日志定位问题：
sudo tail -f /var/log/nginx/error.log
常见报错如connect() to unix:/... failed (13: Permission denied)就是权限问题；No such file or directory是路径写错或 PHP-FPM 没生成 socket
