Traefik反向代理下SonarQube所有API请求返回302重定向问题咨询

1. SonarQube服务端基础配置错误 #

• 检查sonar.properties中的sonar.core.serverBaseURL配置是否和Traefik暴露的外部访问地址完全一致，包括协议（http/https）、域名、端口，路径后缀（如果有）。如果该配置和实际访问地址不匹配，SonarQube会自动生成错误的重定向地址，触发全局302跳转。
• 确认sonar.web.context配置是否为空，如果你没有配置SonarQube运行在子路径下，该值需要留空，错误的上下文路径配置会导致所有请求被重定向到错误的根路径。

2. Traefik反向代理规则配置问题 #

• 检查Ingress/IngressRoute规则是否错误配置了路径重写（PathPrefixStrip或者ReplacePathRegex规则），如果错误剥离了API请求的路径后缀，会导致SonarQube收到的请求始终是根路径，进而重定向到默认的/api入口。
• 确认Traefik是否正确传递了Host头、X-Forwarded-Proto头、X-Forwarded-For头给后端SonarQube，SonarQube依赖这些头识别外部访问环境，缺失或错误的转发头会导致其生成错误的重定向地址。
  你可以添加如下Traefik中间件配置确保头传递正确：

  apiVersion: traefik.containo.us/v1alpha1
  kind: Middleware
  metadata:
    name: sonarqube-headers
  spec:
    headers:
      customRequestHeaders:
        X-Forwarded-Proto: "https" # 对应你实际的外部访问协议
        Host: "your-sonarqube-domain.com" # 对应你实际的访问域名
  

• 检查是否配置了错误的全局重定向规则（比如HTTP强制跳HTTPS的规则）作用于SonarQube的API路径，导致请求被二次重定向。

3. SAML认证配置冲突 #

• 确认Gitlab SAML的回调地址是否和Traefik暴露的SonarQube地址完全一致，错误的回调地址会导致未认证的API请求被SAML中间件拦截后强制重定向到认证入口，而你配置的重定向fallback地址为/api，从而出现全局302。
• 检查SonarQube的SAML插件是否开启了强制所有请求认证的配置，如果你调用API时没有携带有效认证token或者cookie，请求会被拦截后触发重定向，你可以临时关闭强制认证测试API请求是否恢复正常。

4. 代理层Cookie传递问题 #

• 检查Traefik是否没有正确传递SonarQube生成的JSESSIONID Cookie给客户端，或者Cookie的Domain、Path属性配置错误，导致客户端后续请求没有携带认证Cookie，每次请求都被判定为未认证，从而触发重定向。

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