MediaWiki可视化编辑器HTTP 403错误排查求助（Namecheap主机）

以下是针对你遇到的Visual Editor保存时出现Error contacting the Parsoid-/RESTBase-Server (HTTP 403)错误的排查步骤：

• 检查Parsoid端点配置与可用性

  • 打开LocalSettings.php，确认$wgVisualEditorParsoidURL的配置为HTTPS协议，比如设置为：$wgVisualEditorParsoidURL = 'https://' . $_SERVER['HTTP_HOST'] . '/rest.php';，确保和你的域名匹配。
  • 直接在浏览器访问https://你的域名/rest.php，如果返回403，说明这个端点本身被服务器拦截，重点排查主机安全规则；如果返回JSON格式的API响应，说明端点正常，问题出在Visual Editor的请求逻辑。

• 排查主机安全拦截规则

  • Namecheap Stellar共享主机默认启用ModSecurity防火墙，可能误拦截了Parsoid的请求。可以联系主机客服临时关闭ModSecurity测试，或者在主机控制面板的安全模块中查看是否有触发的拦截规则，手动排除相关规则。
  • 检查MediaWiki根目录下的.htaccess文件，查看是否存在限制rest.php访问的规则，比如禁止POST请求、限制特定用户代理的指令，如有则调整规则允许对该文件的正常访问。

• 完善HTTPS相关配置

  • 除了$wgServer，确认$wgCanonicalServer也设置为HTTPS地址：$wgCanonicalServer = 'https://wiki.name.domain.com';，这个参数会影响MediaWiki内部生成的请求URL，不统一可能导致跨协议的权限问题。
  • 确认你的域名SSL证书有效，浏览器访问站点时地址栏显示安全锁图标，无证书警告，证书配置错误可能导致服务器拒绝HTTPS请求。

• 检查文件与目录权限

  • 确保MediaWiki核心文件和目录权限符合共享主机要求：目录权限设为755，文件权限设为644，避免因权限过低导致服务器拒绝访问rest.php或Parsoid相关文件。
  • 检查MediaWiki的cache目录是否有写入权限，权限不足会导致Parsoid无法生成缓存，进而触发403错误。

• 查看服务器错误日志

  • 登录Namecheap主机控制面板，找到Apache或PHP错误日志，查找与rest.php、Parsoid相关的403错误记录。日志会明确标注错误原因，比如具体的ModSecurity规则ID、文件权限问题等，是定位问题的关键依据。

• 验证版本兼容性

  • 访问MediaWiki的Special:Version页面，查看Visual Editor扩展版本与MediaWiki核心版本是否匹配。版本不兼容会导致请求格式不符合服务器预期，进而被拒绝，可对照官方兼容性说明调整版本。

内容的提问来源于stack exchange，提问作者Roman Sheydvasser