自建CodeCov重定向至自建GitLab后出现401未授权问题

问题描述 #

在自建GitLab中添加CodeCov作为第三方应用后，点击CodeCov登录按钮会重定向至GitLab完成授权，但授权成功后仍返回CodeCov登录界面，无法正常进入系统。

相关错误日志如下：

{"message": "Unauthorized: /internal/user", "asctime": "2024-01-30 10:42:05,194", "name": "django.request", "levelname": "WARNING", "lineno": 241, "pathname": "/usr/local/lib/python3.9/site-packages/django/utils/log.py", "funcName": "log_response", "threadName": "MainThread", "status_code": 401, "request": "<WSGIRequest: GET '/internal/user'>", "logger.name": "django.request", "logger.thread_name": "MainThread", "level": "WARNING"}
{"remote_address": "192.168.16.9", "request_time": "[30/Jan/2024:10:42:05 +0000]", "request": "GET /internal/user HTTP/1.1", "status_code": "401", "response_length": "58", "referer": "http://localhost:8080/gle", "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36"}

已尝试调整GitLab应用权限、修改重定向URI为http://localhost:8080/gle，问题仍未解决。

排查与解决建议 #

• 统一域名与协议配置
  确保CodeCov配置的GitLab地址为完整可访问的域名（避免仅本地有效的localhost，除非两者都在本地运行），且双方使用相同的HTTP/HTTPS协议，混合协议会导致令牌或Cookie验证失败。

• 精确匹配回调URI
  登录GitLab后台进入对应CodeCov应用设置，确认回调URI与CodeCov配置完全一致，包括协议、域名、端口和路径，注意路径的大小写、末尾斜杠等细节，URI不匹配会直接导致授权后验证失败。

• 清理浏览器缓存与会话
  清除浏览器中CodeCov和GitLab相关的Cookie、本地存储，重新发起授权流程，避免旧的无效令牌或会话干扰。

• 确认OAuth权限范围
  在GitLab应用设置中，确保勾选read_user、api等核心权限，重新生成应用密钥后更新至CodeCov配置，缺失必要权限会导致CodeCov无法获取用户信息触发401。

• 检查自托管CodeCov的Django配置
  日志错误来自Django的/internal/user接口，需检查CodeCov的Django配置：

  • 确保ALLOWED_HOSTS包含当前访问CodeCov的域名
  • 将GitLab域名添加至CSRF_TRUSTED_ORIGINS，避免跨域验证拦截请求

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