Xiuno BBS 伪静态配置全攻略：多级路由规则详解与实战

52JinY 助手

最近折腾 Xiuno BBS 也有一段时间了，踩了不少坑，今天专门来聊聊 URL 伪静态和多级路由规则这块，希望对还在摸索的朋友有点帮助。

先说说为什么要做伪静态。Xiuno 默认跑出来的链接是带问号参数的那种，比如 index.php?mod=topic&tid=123 这样，看起来很丑不说，对 SEO 也不友好。搜索引擎蜘蛛对动态参数 URL 的抓取权重相对较低，而伪静态能让链接看起来像 /topic/123.html 这种干净的形式，从用户体验和搜索收录两方面都有实质性的改善。

做伪静态之前，首先要确认服务器环境。如果是 Apache，需要开启 mod_rewrite 模块，然后在网站根目录建一个 .htaccess 文件。Nginx 的话则是直接在站点配置文件里加 rewrite 规则。很多人第一次配置失败，往往是因为 Apache 的 AllowOverride 没有设置成 All，导致 .htaccess 根本不生效，白折腾半天。

Xiuno 官方其实提供了基础的伪静态规则模板，在后台"设置"里有对应的 URL 模式选项。打开之后系统会给你生成一段规则代码，直接复制粘贴到配置文件即可。但问题来了——如果你的论坛目录不是根目录，而是在某个子目录下运行，比如 /bbs/ 这样的路径，那官方给的规则就需要手动调整前缀，不然跳转会乱掉。我当时就是这么翻车的，调试了整整一个下午才发现是路径前缀没对。

多级路由规则这部分稍微复杂一些。Xiuno 支持自定义 URL 结构，比如你想做成 /forum/板块ID/帖子ID.html 这种层级感更强的格式，就需要在路由配置里额外定义规则。核心思路是把所有请求先统一转发到 index.php，再由 Xiuno 内核去解析具体的路由参数。Nginx 下常用的写法大概是这样：先判断请求的文件或目录是否真实存在，不存在的话就 rewrite 到 index.php 并把原始 URI 作为参数传进去。

要注意一个细节，Xiuno 的路由解析对斜杠结尾比较敏感，有时候 /forum/12/ 和 /forum/12 会被当成两个不同的路径处理，导致其中一个出现 404。建议在规则里加上 rewrite 的时候统一处理一下末尾斜杠，要么全部加，要么全部去掉，风格统一就不会出问题。

另外还有一个容易被忽略的点，就是静态资源和伪静态规则的冲突问题。CSS、JS、图片这些真实存在的文件，如果 rewrite 规则写得太宽泛，会被一起重定向到 index.php 去，页面直接炸掉。正确的做法是在规则最开头加上对真实文件和目录的排除判断，先 check 是否是真实路径，确认不是再执行 rewrite，这是最基本的写法规范。

配置完之后记得清一下浏览器缓存再测试，不然老缓存会干扰判断。用 curl 命令行测试各个路径的响应状态码也很直观，看到 200 就是正常，出现 301/302 就说明有跳转链，跟踪一下看最终落地是不是预期的地址。如果出现 500，多半是配置文件语法写错了，Apache 下可以用 apachectl configtest 检查，Nginx 用 nginx -t 排查。

总体来说 Xiuno 的伪静态配置不算太难，关键是要搞清楚自己的服务器环境、部署目录以及想要的 URL 格式，三点确认清楚了再动手，少走弯路。有具体问题的可以在楼下说一下环境和报错信息，能帮的尽量帮。