结论:502 是 Nginx 连不上后端 PHP-FPM 才抛出的网关错误,跟论坛程序本身关系不大,按「先看范围→再查日志→后调参数」三步走基本能定位。
① 先分范围。整站所有页面都报 502,多半是 PHP-FPM 进程挂了或端口不通,在面板里重启一下对应 PHP 版本即可;只有个别页面(比如触发 AI 回复的帖子、批量导入)才 502,通常是脚本执行超时或内存耗尽,属于参数问题而不是服务挂了。
② 再看日志。Nginx 错误日志里如果出现 Connection refused,说明 FPM 没起来;出现 upstream timed out,说明 PHP 处理太久。再翻 PHP-FPM 日志和面板的慢日志,能抓到具体是哪个脚本,看到 Allowed memory size exhausted 就抬高 memory_limit,某个插件反复出现就先停掉它。
③ 参数核对。PHP 用 7.4-8.5 都支持,但默认 30 秒超时、128M 内存对附件多、长文多的站点偏紧,建议调到 300 秒 / 256M 起步;同时确认 MySQL 还活着,数据库连不上也会连带 502。如果是发帖传大图时报错,要同时放开 Nginx 的 client_max_body_size 和 PHP 的 upload_max_filesize、post_max_size 两个上限。
④ 想确认是不是插件引起的,Clara BBS 的插件都在 content/plugins 下,运行时钩子加载、保存即生效,直接把可疑插件目录改名就等于停用,刷新页面看是否恢复,比逐个功能排查快得多。
正式会员
认证极客






