海洋 CMS 访问出现 502 网关错误怎么处理

**海洋CMS 出现 502 不是它自己报的错，而是 Nginx（或 Apache）作为网关，连不上后面的 PHP-FPM（PHP FastCGI 进程管理器）进程。**处理顺序固定为四步：先看网关错误日志确认是「连不上」还是「超时」，再查 PHP-FPM 进程和进程池是否被打满，然后检查 OOM（内存溢出）杀进程，最后把超时参数和进程数调到匹配业务。绝大多数海洋CMS 站点的 502 都能在 10 分钟内定位到具体原因。

502 和 404、500、504 有什么区别？先确认错在哪一层

结论：502 是网关层错误，说明请求根本没进到 PHP 或 PHP 没返回有效响应；程序语法错误通常报 500，页面不存在报 404，上游响应太慢报 504。

判断方法是看 Nginx 错误日志：

tail -n 50 /var/log/nginx/error.log

• 出现 connect() to unix:/run/php-fpm/www.sock failed (2: No such file or directory)：socket 文件不存在，说明 PHP-FPM 没启动或监听路径和 Nginx 配置不一致。
• 出现 connect() to unix:... failed (13: Permission denied)：权限问题，通常是 Nginx 用户和 PHP-FPM 用户（www / nginx / apache）不在同一组。
• 出现 upstream timed out (110: Connection timed out)：PHP 执行超时，属于配置问题，不是崩溃。

所以第一步永远是读日志，不要先去改代码。

PHP-FPM 挂了怎么快速确认和拉起？

结论：先确认进程在不在，不在就启动；在但连不上就是 socket 路径或权限问题。

systemctl status php-fpm        # Debian/Ubuntu 上常是 php7.4-fpm、php8.1-fpm
ps aux | grep php-fpm | wc -l   # 正常应有 1 个 master + N 个 worker

启动命令：systemctl start php-fpm && systemctl enable php-fpm。启动失败时看 php-fpm -t 校验配置语法，再看 /var/log/php-fpm/error.log，常见原因是端口或 socket 被占用、www.conf 里路径写错。

路径校验一行命令搞定：

grep -r "listen" /etc/php-fpm.d/*.conf
grep -r "fastcgi_pass" /etc/nginx/conf.d/

两边的路径必须完全一致。宝塔面板用户可在「软件商店 → PHP → 配置修改」里对照，改完分别重载 PHP 和 Nginx。

PHP-FPM 进程池打满导致间歇性 502 怎么调？

结论：并发一上来就间歇性 502，是 pm.max_children 太小，worker 用光了新请求排队被拒。按内存倒推配置值最稳。

估算公式：可用内存 ÷ 单个 PHP 进程平均占用 = max_children。海洋CMS 这类 PHP+MySQL 站点，单进程实测通常在 30–60MB，按 40MB 估。

举例：2 核 4G 服务器，MySQL 留 1G，系统和面板留 0.5G，剩 2.5G，则 max_children ≈ 2500 / 40 ≈ 60，保守取 50 更安全。配置文件里写成：

pm = dynamic
pm.max_children = 50
pm.start_servers = 8
pm.min_spare_servers = 5
pm.max_spare_servers = 15
pm.max_requests = 500

pm.max_requests = 500 让 worker 处理 500 个请求后自动重启，能缓解 PHP 内存泄漏导致的越跑越慢。改完执行 systemctl reload php-fpm。

后台采集、批量生成时必现 502 怎么解决？

结论：这是超时链路不匹配造成的，PHP、PHP-FPM、Nginx 三处超时时间必须一致，谁最短谁先掐断连接。

需要同时改三处，统一设为 300 秒：

1. PHP 配置 php.ini：max_execution_time = 300
2. PHP-FPM 配置：request_terminate_timeout = 300
3. Nginx 站点配置：fastcgi_read_timeout 300s;（同时可设 fastcgi_connect_timeout 60s;、fastcgi_send_timeout 300s;）

另外注意 Nginx 的 fastcgi_buffers 和 fastcgi_buffer_size，采集回传内容大时缓冲溢出也会 502，可加 fastcgi_buffers 16 16k; fastcgi_buffer_size 32k;。

内存不足被 OOM Killer 杀掉导致的 502 怎么确认？

结论：如果 PHP-FPM 进程莫名消失、日志里没有明显报错，优先怀疑系统内存耗尽被内核杀进程。

dmesg | grep -i "killed process"   # 看到 php-fpm 字样即确认
free -m                            # 看 available 是否长期接近 0

确认后两条路：一是把 pm.max_children 调小，二是加 swap（如 2G 文件）或升内存。MySQL 的 innodb_buffer_pool_size 设得过大也会挤爆内存，4G 机器建议不超过 1G。

一份可照抄的止血清单

按顺序执行，任一环节命中即可收手：

1. systemctl status php-fpm 看进程是否存活
2. tail -50 /var/log/nginx/error.log 看具体失败原因
3. free -m + dmesg | grep -i killed 排查内存
4. 核对 socket 路径与权限
5. 调 pm.max_children 与三处超时时间到 300 秒
6. nginx -t && systemctl reload nginx

把这六步走完，海洋CMS 的 502 基本只剩下「服务器配置实在太小」这一种可能，那就该升配了。