在 apache 中配置 discuz 伪静态，核心做法是启用 mod_rewrite 模块并加载 discuz 提供的 .htaccess 规则文件。具体操作是在 apache 主配置文件或虚拟主机配置中开启 rewriteengine，确保 allowoverride 设置为 all 以允许读取 .htaccess，然后将 discuz 根目录下的 .htaccess 文件上传至服务器。这样访问者请求的 url 会被重写为内部处理的 php 脚本路径，实现 seo 友好的静态路由效果。
如何启用 Apache 的 URL 重写功能
要支持伪静态，必须确保 Apache 加载了 mod_rewrite.so 模块并在配置中允许覆盖设置。在 Debian/Ubuntu 系统下，通常使用 a2enmod rewrite 命令启用该模块，而在 CentOS/RHEL 系统中则需在 httpd.conf 中取消注释 LoadModule rewrite_module modules/mod_rewrite.so。接着，需要修改虚拟主机配置，将 AllowOverride 指令设为 All，否则 Apache 会忽略站点目录中的 .htaccess 文件，导致伪静态失效。
# /etc/apache2/sites-available/discuz.conf
<VirtualHost *:80>
ServerName www.example.com
DocumentRoot /var/www/discuz
<Directory /var/www/discuz>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/discuz_error.log
CustomLog ${APACHE_LOG_DIR}/discuz_access.log combined
</VirtualHost>
上述配置片段展示了标准的虚拟主机设置。关键点是 AllowOverride All，它告诉 Apache 检查当前目录下的 .htaccess 文件并应用其中的重写规则。如果此处设置为 None，即使安装了 mod_rewrite 模块，Discuz 的重写规则也不会生效。重启 Apache 服务后，可以通过访问一个帖子链接来验证是否成功，若返回 404 错误，请检查日志文件或确认 .htaccess 文件是否存在且权限正确。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
Discuz 伪静态规则的具体内容与作用
Discuz 的伪静态规则主要位于其安装目录下的 .htaccess 文件中，这些规则定义了如何将用户友好的 URL 映射到实际的 PHP 脚本。典型的规则包括处理论坛列表、帖子详情、用户空间等常见场景。例如，将 /forum-123-1.html 重写为 viewthread.php?tid=123&page=1。这些规则通常以 RewriteRule 开头，配合正则表达式匹配 URL 模式，并使用 [L] 标志表示这是最后一条规则，停止进一步处理。
# Discuz .htaccess 示例片段 RewriteEngine On RewriteBase / # 处理版块列表 RewriteRule ^forum-(\w+)-([0-9]+)\.html$ forumdisplay.php?fid=$1&page=$2 [L,QSA] # 处理帖子详情 RewriteRule ^thread-(\w+)-([0-9]+)-([0-9]+)\.html$ viewthread.php?tid=$1&extra=page%3D$3&page=$2 [L,QSA] # 处理用户空间 RewriteRule ^space-uid-([0-9]+)\.html$ home.php?mod=space&uid=$1 [L,QSA]
这段代码展示了 Discuz 核心的重写逻辑。第一行 RewriteEngine On 激活引擎，RewriteBase / 指定基准路径。随后的规则使用括号捕获组提取参数，如 (\w+) 匹配版块 ID 或帖子 ID，([0-9]+) 匹配页码。QSA 标志（Query String Append）确保原始查询字符串被附加到新 URL 中，这对于分页等功能至关重要。开发者在调试时，应重点关注正则表达式是否正确匹配了实际访问的 URL 结构，以及捕获组的顺序是否与目标脚本的参数期望一致。
当 .htaccess 文件缺失或权限错误时会发生什么
如果 .htaccess 文件不存在或 Apache 进程没有读取权限，所有伪静态规则将被忽略，网站回退到动态 URL 模式。这意味着用户访问 /forum-123-1.html 时，Apache 会尝试寻找名为 forum-123-1.html 的实际物理文件，由于该文件不存在，服务器将返回 404 Not Found 错误。此外，如果文件存在但权限设置为 644 而 Apache 用户无法读取，同样会导致规则失效。这种情况下，网站虽然能正常显示首页，但所有内链和 SEO 优化链接均无法正常工作，严重影响用户体验和搜索引擎收录。
