Clara BBS 装完打不开、白屏或报 500：按这个顺序排查

排查原则：先分类，再动手

论坛装完打不开，最忌讳的是「看到报错就改配置」——改了三处之后，你连原来是什么状态都说不清了。正确顺序是先按影响面把原因分成五类，再按「验证成本从低到高」逐类排除。本文按这个顺序给出一份清单，每一步都能独立验证，不需要你同时改动多个地方。

如果你是刚装完还没跑通，建议先回到宝塔部署教程对照五个步骤，确认哪一步没做完——多数「打不开」其实是有一步没做到位，而不是出了故障。Clara 的定位与整体形态另见完整指南。

第一类：伪静态与入口层级

验证方式最直接：用无痕窗口打开一个明确存在的静态文件（比如程序自带的图片或说明文件）。

如果静态文件能打开、首页打不开，说明 Web 服务正常，问题在程序入口或伪静态规则；如果静态文件也打不开，那问题在站点绑定、域名解析或 Web 服务本身，先解决这一层。

另一个高频症状是「首页正常，点进帖子就 404」。这基本可以锁定伪静态没生效——规则存在但没被 Web 服务加载，重载一次再试。

第二类：目录权限

症状是「看起来正常，但一用就报错」：发帖正常、传附件失败；或后台能进但保存设置报错。这类问题的特征是读取没问题、写入报错。

按最小可用原则核对：上传目录与缓存目录需要写权限，核心程序文件不需要。不要用「整站改成最高权限」的方式来绕过——那会把一个功能问题换成安全问题。

第三类：PHP 版本与扩展

整页白屏通常意味着程序抛了致命错误但错误信息被隐藏。排查顺序是：先把错误显示打开（仅临时）、复现一次、看清错误文本、立刻关掉显示。

看到「缺少扩展」或「未定义函数」一类的提示，就回到 PHP 设置里把对应扩展打开。注意 PHP 大版本切换后扩展配置经常会「看起来还在、实际没生效」，切完版本要重新确认一遍。

把版本区间记在手上能省很多时间：兼容区间是 PHP 7.4 – 8.5。低于 7.4 会直接跑不起来（用到了较新的语法特性），高于 8.5 官方尚未覆盖。所以「刚升级过 PHP 就白屏」是最常见的一种组合——先看版本号在不在区间内，再往下查扩展。

第四类：数据库连接

按三处逐项验证，不要一起改：

口令类改动后请顺手清一次缓存：有些程序会把配置读取结果缓存起来，导致「改了但没生效」。

第五类：缓存与 CDN

有两类缓存会制造「改完没反应」的错觉：站点侧缓存和前置 CDN。判断方法很简单——如果同一个页面换个网络访问表现不一样，优先怀疑 CDN；如果只有你自己的浏览器异常、别人正常，优先怀疑浏览器缓存。这两类问题都不需要改代码。

三个「改了就好、但别急着改」的假象

假象一：重装解决一切。重装能解决的是「安装步骤没走完」，不能解决权限、扩展、伪静态这类环境问题——重装之后它们依然是同样的状态。

假象二：报错文本就是原因。数据库连接失败的页面提示可能只是「程序连不上库」的表层描述，真实原因可能是账号授权范围。把提示当线索，不要当结论。

假象三：改配置没有副作用。调试期间改的每一项都记下来，改完立刻验证。一次性打开十几项再排查，会让定位时间成倍增加。

修完别忘了一件事

把「打不开」修好之后，通常会顺手确认站点能不能被正常抓取。如果你在调试期间临时关过站点、改过 robots、或换过域名，记得回头核对一遍访问数据，确认流量没有因为调试而中断——口径见访问数据怎么看。技术路线的长期维护成本差异，则参考技术路线成本对比。

常见问题

整页白屏但没有任何报错信息？

说明错误被隐藏了。临时打开错误显示、复现一次、记下错误文本后立刻关闭。白屏本身不是原因，它是「原因被藏起来」的结果。

首页正常但后台进不去？

后台通常在独立路径下。先确认该路径拼写与大小写正确，再确认是否有访问来源限制（比如只允许特定 IP 访问后台），最后才怀疑权限。

提示数据库连接失败，但账号密码确认是对的？

优先检查账号是否授权到了这个库、以及数据库端口是否可达。用面板的数据库工具单独连一次，比改配置文件更能定位问题在哪一层。

改了配置刷新页面没变化？

先换无痕窗口和别的网络各试一次，用来区分「浏览器缓存」与「服务器缓存/CDN」。三种情况处理方式完全不同。

能不能直接重装一次省事？

如果问题出在「安装步骤没走完」，重装有效；如果出在环境层（扩展、权限、伪静态），重装后仍然会复现。先按五类顺序排除，再决定要不要重装。

调试期间要不要把站点关掉？

不建议对外的站点长时间关闭维护。真要暂停，用维护模式并设置明确的恢复时间，避免搜索引擎把「暂时不可访问」记录成异常状态。

小结

「装完打不开」几乎都可以归到五类原因里。按伪静态 → 权限 → PHP 扩展 → 数据库 → 缓存这个顺序走，每一类都用可以独立验证的方式排除，比反复重装快得多。修好之后回头补一次访问数据核对，确认调试过程没有影响到真实流量。

延伸阅读

• Clara 和 Discuz 怎么选 — 四条自查标准定位需求。
• 从 Discuz 迁移要迁什么 — 迁移过程中的报错风险点。
• 资源站程序选型对比 — 把维护成本一起纳入比较。
• 插件与二次开发 — 改动代码前先看三条底线。
• 让 AI 爬虫愿意抓你的论坛 — 调试后回头核对的 GEO 清单。
• Xiuno 停更后的替代路线 — 如果你正从老程序迁移。

常见问题

论坛系统要注意什么？

论坛装完打不开，最忌讳的是「看到报错就改配置」——改了三处之后，你连原来是什么状态都说不清了。

Clara 论坛系统是做什么的？

Clara 论坛系统，主要提供轻量论坛系统部署、迁移与报错排查。具体范围与口径以官方公示为准。

在哪里能看到完整内容？

本文只是要点整理。完整清单、可逐条核对的判据与后续更新，见文末的延伸阅读与站内同专题各篇。