2026年6月10日 (三) 22:02 Doge24190

2026-06-10T22:02:17Z

2026年6月10日 (三) 21:41 Doge24190

2026-06-10T21:41:17Z

Doge24190：创建页面，内容为“= MediaWiki 页面显示 Nginx 404 的排查记录：error_page 404 导致的隐藏问题 = == 问题现象 == 在安装并配置好 MediaWiki 后，首页可以正常打开，部分特殊页面也可以正常访问，例如： `https://wiki.example.com/index.php?title=特殊:上传文件` 但是访问另一些页面时却出现 404，例如： https://wiki.example.com/index.php?title=特殊:最近更改 2026-06-10T21:32:36Z 创建页面，内容为“= MediaWiki 页面显示 Nginx 404 的排查记录：error_page 404 导致的隐藏问题 = == 问题现象 == 在安装并配置好 MediaWiki 后，首页可以正常打开，部分特殊页面也可以正常访问，例如： <code><nowiki>https://wiki.example.com/index.php?title=特殊:上传文件</nowiki></code> 但是访问另一些页面时却出现 404，例如： <code><nowiki>https://wiki.example.com/index.php?title=特殊:最近更改</nowiki></co…” 新页面 = MediaWiki 页面显示 Nginx 404 的排查记录：error_page 404 导致的隐藏问题 = == 问题现象 == 在安装并配置好 MediaWiki 后，首页可以正常打开，部分特殊页面也可以正常访问，例如： <code><nowiki>https://wiki.example.com/index.php?title=特殊:上传文件</nowiki></code> 但是访问另一些页面时却出现 404，例如： <code><nowiki>https://wiki.example.com/index.php?title=特殊:最近更改</nowiki></code> 以及访问尚未创建的普通页面时也会出现 404，例如： <code><nowiki>https://wiki.example.com/index.php?title=Test</nowiki></code> 表面上看，问题似乎像是 MediaWiki 的特殊页面、本地化别名、URL 重写或 Nginx 伪静态规则出了问题。但进一步检查后发现，真正的问题并不是 MediaWiki 没有处理请求，而是 Nginx 把 MediaWiki 返回的应用内 404 页面覆盖掉了。 == 排查过程 == 首先使用 curl 测试英文特殊页面： <code>curl -I "<nowiki>https://wiki.example.com/index.php?title=Special:RecentChanges</nowiki>"</code> 返回结果中可以看到，MediaWiki 实际上已经识别了这个特殊页面，并将其重定向到了中文特殊页名称： <code>HTTP/2 301 location: <nowiki>https://wiki.example.com/index.php?title=%E7%89%B9%E6%AE%8A:%E6%9C%80%E8%BF%91%E6%9B%B4%E6%94%B9</nowiki></code> 这说明 MediaWiki 本身是工作的，<code>Special:RecentChanges</code> 也能被识别。然后继续跟随跳转查看页面正文： <code>curl -L "<nowiki>https://wiki.example.com/index.php?title=Special:RecentChanges</nowiki>" | head -n 50</code> 返回内容却是： <code><html> <head><title>404 Not Found</title></head> <body> <nowiki><center><h1>404 Not Found</h1></nowiki><nowiki></center></nowiki> <nowiki><hr></nowiki><nowiki><center>nginx</center></nowiki> </body> </html></code> 这里的关键点是： <code>nginx</code> 如果是 MediaWiki 自己返回的页面，HTML 中通常会包含 MediaWiki 的页面结构、皮肤、站点标题等内容；而这里显示的是 Nginx 默认 404 页面。因此可以判断：这个 404 不是 MediaWiki 页面本身，而是被 Nginx 的错误页处理逻辑替换了。 == 根本原因 == 在宝塔面板生成的 Nginx 配置中，存在如下配置： <code>error_page 404 /404.html;</code> 完整片段类似： <code>#ERROR-PAGE-START 错误页配置，可以注释、删除或修改 error_page 404 /404.html; #error_page 502 /502.html; #ERROR-PAGE-END</code> 这个配置的含义是：只要后端返回 HTTP 404，Nginx 就将页面替换为 <code>/404.html</code>。这对于普通静态网站可能没问题，但对 MediaWiki 这类动态应用来说会造成误伤。 MediaWiki 在很多情况下会主动返回 HTTP 404 状态码，但页面正文并不是错误，而是应用内的正常提示。例如： * 访问尚未创建的页面； * 访问不存在的标题； * 某些特殊页面或查询结果为空的页面； * 需要由 MediaWiki 自己生成的“页面不存在，可创建此页面”提示。也就是说，对于 MediaWiki 来说，HTTP 404 并不一定代表 Nginx 层面的文件不存在。它可能只是 MediaWiki 用来表达“这个 wiki 页面尚未创建”的正常状态码。但是 Nginx 的： <code>error_page 404 /404.html;</code> 会把 MediaWiki 自己生成的页面内容覆盖掉，最终用户看到的就不再是 MediaWiki 的提示，而是 Nginx 的： <code>404 Not Found nginx</code> 这就是导致“未创建页面打不开”“部分特殊页面变成 404”的真正原因。 == 解决方法 == 编辑站点的 Nginx 配置文件，例如宝塔环境下通常位于： <code>/www/server/panel/vhost/nginx/wiki.example.com.conf</code> 找到： <code>error_page 404 /404.html;</code> 将其注释掉： <code>#error_page 404 /404.html;</code> 修改后的配置应类似： <code>#ERROR-PAGE-START 错误页配置，可以注释、删除或修改 #error_page 404 /404.html; #error_page 502 /502.html; #ERROR-PAGE-END</code> 然后测试 Nginx 配置： <code>sudo nginx -t</code> 如果显示配置正常，再重载 Nginx： <code>sudo systemctl reload nginx</code> 宝塔环境也可以使用： <code>sudo /etc/init.d/nginx reload</code> == 修复后的效果 == 修改后，再访问未创建页面： <code><nowiki>https://wiki.example.com/index.php?title=Test</nowiki></code> 它可能仍然返回 HTTP 404 状态码，这是正常的，因为 <code>Test</code> 页面确实尚未创建。但页面正文不应再是 Nginx 的： <code>404 Not Found nginx</code> 而应该变成 MediaWiki 自己的提示页面，例如： <code>此页面目前没有内容。您可以搜索本页标题、在相关页面中搜索，或者创建此页面。</code> 也就是说，判断问题是否修复，不能只看 HTTP 状态码是否为 404，而要看页面正文到底是 MediaWiki 生成的，还是 Nginx 生成的。可以用下面的命令检查： <code>curl -L "<nowiki>https://wiki.example.com/index.php?title=Test</nowiki>" | head -n 30</code> 如果输出中出现 MediaWiki 页面结构，说明已经正常。 == 推荐的 MediaWiki Nginx 基础配置 == 对于使用 <code>/index.php?title=页面名</code> 这种默认 URL 形式的 MediaWiki 站点，可以保留简单的基础转发规则： <code>location / { try_files $uri $uri/ /index.php?$query_string; }</code> 同时建议在 <code>LocalSettings.php</code> 中明确使用保守的 URL 配置： <code>$wgScriptPath = ""; $wgArticlePath = "/index.php?title=$1"; $wgUsePathInfo = false; $wgServer = "<nowiki>https://wiki.example.com</nowiki>";</code> 这样可以避免 MediaWiki 生成 <code>/index.php/PageName</code> 或短链接形式的路径，从而减少和 Nginx URL 重写规则冲突的概率。 == 关于未创建页面的 404 状态码 == 需要特别注意：MediaWiki 中访问未创建页面返回 HTTP 404 是正常行为。例如： <code><nowiki>https://wiki.example.com/index.php?title=Test</nowiki></code> 如果 <code>Test</code> 页面尚未创建，MediaWiki 可以返回 404 状态码，同时显示“页面不存在，可创建此页面”的提示。因此，排查时不能简单认为： <code>HTTP 404 = Nginx 配置错误</code> 更准确的判断方式是： * 如果页面正文是 MediaWiki 风格的“页面不存在”提示，说明正常； * 如果页面正文是 <code>404 Not Found nginx</code>，说明被 Nginx 错误页覆盖了； * 如果访问 <code>/index.php</code> 本身也 404，才更可能是站点根目录或 PHP 转发规则错误。 == 总结 == 这次问题的关键不在 MediaWiki 数据库，也不在特殊页面本身，而是在 Nginx 配置中的： <code>error_page 404 /404.html;</code> 该配置会覆盖 MediaWiki 自己生成的 404 页面，导致： * 未创建页面无法显示 MediaWiki 的创建提示； * 部分特殊页面看起来像是 Nginx 404； * 排查方向容易误判为 URL 重写、PathInfo 或 MediaWiki 本地化问题。最终解决方法很简单： <code>#error_page 404 /404.html;</code> 对 MediaWiki、DokuWiki、WordPress 等动态应用来说，通常不建议让 Nginx 直接覆盖应用层返回的 404 页面。应用自己的 404 页面往往包含有用的操作入口、创建页面提示、搜索入口或权限提示。如果被 Nginx 统一替换，会破坏应用的正常交互逻辑。

MediaWiki页面显示Nginx404 - 版本历史

2026年6月10日 (三) 22:02 Doge24190

2026年6月10日 (三) 21:41 Doge24190