XiunoBBS 空白页/白屏问题完整修复指南

安装后一片空白？后台打不开？折腾半天不知道问题出在哪？这篇文章帮你一次性解决所有 XiunoBBS 空白问题。

一、问题概述

XiunoBBS 是一款轻量级、高性能的 PHP 论坛系统，以速度快、资源占用低著称。但在使用过程中，很多用户会遇到"白屏"或"空白页"的问题------页面什么都不显示，没有任何错误提示，让人无从下手。

本文适用于以下情况：

• 安装完成后首页一片空白

• 后台 /admin 无法访问，显示白屏

• 安装插件或模板后全站打不开

• 迁移服务器后页面空白

根据官方社区的反馈，这类问题在 XiunoBBS 4.x 版本中非常常见，但大多都有成熟的解决方法。

二、问题原因分析

XiunoBBS 出现空白页的原因主要有以下几类：

注意：XiunoBBS 官方已停止更新维护，官方版本最高只支持 PHP 7.2 左右，社区魔改版本有的可以支持到 PHP 8.0。

三、解决方案（按难易程度排序）

方案一：清理 tmp 缓存（最简单，成功率最高）

这是官方社区版主和众多用户反复验证的最常用方法。

操作步骤：

1. 通过 SSH 或 FTP 连接到你的服务器

2. 进入 XiunoBBS 的安装根目录

3. 找到 /tmp/ 文件夹

4. 删除该文件夹内的所有文件（保留 tmp 文件夹本身！）

5. 刷新网页查看是否恢复正常

注意事项：

• 只删除文件，不要删除 tmp 文件夹

• Linux 命令示例：

bash

cd /你的论坛路径/tmp rm -rf * 

这个方法可以解决大部分因缓存引起的白屏问题。

方案二：检查并修复目录权限

XiunoBBS 需要以下几个目录具有写入权限，否则会导致白屏或报错：

需要检查权限的目录：

• /tmp/ - 缓存目录

• /log/ - 日志目录

• /upload/ - 上传目录

• /conf/ - 配置文件目录（部分情况需要）

权限设置方法：

方法A：FTP客户端设置

1. 使用 FTP 连接服务器

2. 右键点击对应的文件夹

3. 选择"文件权限"或"属性"

4. 设置为 755 或 777

5. 勾选"应用到子目录"

方法B：SSH命令设置

bash

cd /你的论坛根目录 chmod -R 777 tmp chmod -R 777 log chmod -R 777 upload chmod -R 755 conf 

关于777和755的选择：

• 一般情况设置 755 即可

• 如果755不生效，可以尝试 777

• 部分安全要求高的主机使用 775

方案三：调整 PHP 版本（解决兼容性问题）

XiunoBBS 不同版本对 PHP 版本有不同要求：

操作方法：

如果使用宝塔面板：

1. 进入网站设置

2. 点击"PHP版本"

3. 切换为 PHP 7.2 或 PHP 7.1

4. 清除缓存后测试

如果使用命令行：

bash

# 查看当前PHP版本 php -v # 切换PHP版本（需要根据你的环境配置） update-alternatives --config php 

官方建议：如果不确定用哪个版本，直接使用 PHP 7.1 最为稳妥。

方案四：开启调试模式，查看具体错误

如果上述方法都不行，需要打开调试模式，让错误信息显示出来。

步骤1：修改 index.php

找到论坛根目录下的 index.php 文件，找到以下代码：

php

!defined('DEBUG') AND define('DEBUG', 0); 

将其中的 0 改为 2：

php

!defined('DEBUG') AND define('DEBUG', 2); 

步骤2：修改 php.ini（可选）

如果有服务器权限，可以开启 PHP 错误显示：

ini

display_errors = On error_reporting = E_ALL 

步骤3：刷新页面查看报错信息

修改后刷新白屏页面，会显示具体的 PHP 错误信息，根据提示解决问题。

步骤4：恢复调试模式

解决问题后，务必将 DEBUG 改回 0，避免暴露敏感信息。

查看日志文件：
如果没有开启调试，也可以直接查看 log/日期/php_error.php 文件中的错误记录。

方案五：禁用冲突插件或模板

如果问题出现在安装某个插件或模板之后，那么很可能是插件或模板与当前环境不兼容。

方法A：通过配置文件禁用所有插件

编辑 /conf/conf.php 文件，添加或修改：

php

'disabled_plugin' => 1, 

这行代码会禁用所有插件，如果网站恢复正常，说明是插件冲突。

方法B：手动删除问题插件

通过 FTP 或文件管理器进入 /plugin/ 目录，删除最后安装的那个插件文件夹。

方法C：禁用问题模板

如果是更换模板后出现的问题：

• 进入 /view/ 目录

• 找到当前使用的模板文件夹

• 暂时改名（如 moxing 改为 moxing_backup）

• 系统会自动切换到默认模板

方案六：检查文件完整性

问题表现：某些页面正常，某些页面空白

可能原因：

• FTP 上传时文件不完整（半截文件）

• 编码问题（BOM头等）

解决方法：

1. 重新上传文件：使用二进制模式重新上传所有文件

2. 检查文件编码：确保 PHP 文件是无 BOM 的 UTF-8 编码

3. 重新下载安装包：从官网或可靠来源重新下载完整包

方案七：解决语言包问题

如果是在后台切换语言后出现空白，可以按以下步骤修复：

1. 进入 /lang/ 目录

2. 将当前语言文件夹改名（如 zh_cn 改为 zh_cn_bak）

3. 清空 /tmp/ 目录

4. 重新访问网站，系统会自动生成默认语言配置

四、常见问题排查流程

如果你不确定问题出在哪里，请按以下顺序排查：

text

第一步：清空 tmp 目录     ↓ 无效 第二步：检查目录权限（tmp、log、upload）     ↓ 无效   第三步：切换 PHP 版本（优先尝试 7.1）     ↓ 无效 第四步：开启 DEBUG=2 查看具体错误     ↓ 根据错误提示解决 第五步：如有报错，根据报错内容处理 

五、特殊情况处理

情况1：后台白屏但前台正常

原因：通常是后台插件或菜单相关的问题。

解决方法：

1. 通过配置文件禁用所有插件

2. 或手动删除最近安装的后台相关插件

3. 清理 tmp 缓存

情况2：安装时提示目录不可写

问题描述：

text

../log/ 不可写 ../tmp/ 不可写 ../upload/ 不可写 

原因：安装包缺少这三个文件夹

解决方法：

1. 手动创建 log、tmp、upload 三个文件夹

2. 设置权限为 755 或 777

3. 重新安装

情况3：主题与插件冲突

问题描述：安装了某个高级主题后，某些插件功能失效或页面空白。

解决方法：

1. 暂时切换回默认主题测试

2. 确认是冲突后，联系主题作者寻求兼容方案

3. 或在主题中手动修改相关代码

六、预防措施

1. 定期备份：修改任何文件前先备份原文件

2. 谨慎安装插件：只安装经过测试、兼容你当前版本的插件

3. 保留测试环境：重大修改前先在本地或测试站验证

4. 记录修改：记录对系统文件的修改，方便回溯

5. PHP版本稳定：确定稳定版本后不要轻易升级PHP

七、总结

XiunoBBS 空白页问题虽然烦人，但90%的情况都可以通过清理tmp目录 + 检查目录权限 + 调整PHP版本这三步解决。

快速检查清单：

• 清空了 /tmp/ 目录

• /tmp/、/log/、/upload/ 目录权限为 755 或 777

• PHP 版本为 7.1 或 7.2

• 排查了最近安装的插件/模板

• 开启了 DEBUG=2 查看报错

如果以上方法都试过了还是不行，建议去官方论坛（xiunobbs.cn）发帖求助，记得附上 DEBUG 模式下的报错信息，方便别人快速帮你定位问题。

希望这篇教程能帮你解决 XiunoBBS 的空白问题！如果问题解决了，欢迎回来留言分享你的解决方案，帮助更多遇到同样问题的人。