GitLab EE帮助页面点击链接出现重复路径重定向问题求助

问题现象 #

• 打开GitLab EE帮助页面git.domain.com/help后，点击任意帮助链接，生成的URL会重复出现/16.7/ee片段，示例异常URL：

  https://git.domain.com/help/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/16.7/ee/user/index.html
  

• 正确的URL格式应为：

  https://git.domain.com/help/16.7/ee/user/index.html
  

• 即使直接访问正确格式的链接，点击页面内的帮助链接仍会出现路径重复问题

可能的排查与解决方向 #

1. 检查GitLab核心配置

   • 打开gitlab.rb配置文件，确认external_url参数是否设置正确，避免包含重复的/help/[version]/ee路径片段。
   • 修改配置后执行sudo gitlab-ctl reconfigure重新加载配置，再测试链接生成情况。

2. 排查帮助页面模板变量

   • 该问题大概率是版本号或EE标识的变量在页面模板中被重复调用拼接导致。对于自部署实例，可查看GitLab源码中帮助页面的模板文件，确认路径生成逻辑中变量是否仅被引用一次。
   • 若使用官方Omnibus包，可尝试升级到对应版本的最新小版本，修复可能存在的模板渲染bug。

3. 验证反向代理配置

   • 如果GitLab前端有反向代理（如Nginx），检查代理配置中的重写规则，是否存在循环追加/[version]/ee路径的错误逻辑。
   • 确保代理规则仅对必要路径进行重写，避免重复拼接。

4. 清理缓存

   • 执行sudo gitlab-rake cache:clear清理GitLab服务器端缓存，同时清空浏览器本地缓存后重新测试，排除旧缓存导致的异常。

临时应急方案 #

紧急情况下，可手动删除URL中重复的/16.7/ee片段，保留单次路径后访问帮助页面。

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