部署后使用Google Auth登录出现Correlation failed及远程登录处理错误

错误详情 #

处理请求时发生未处理的异常。
Exception: Correlation failed.
Unknown location

Exception: 处理远程登录时遇到错误。
Microsoft.AspNetCore.Authentication.RemoteAuthenticationHandler.HandleRequestAsync()

Stack Query Cookies Headers Routing
Exception: Correlation failed.

显示原始异常详情
System.Exception: Correlation failed.
Exception: 处理远程登录时遇到错误。
Microsoft.AspNetCore.Authentication.RemoteAuthenticationHandler.HandleRequestAsync()
Microsoft.AspNetCore.Authentication.AuthenticationMiddleware.Invoke(HttpContext context)
Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context)

显示原始异常详情
System.Exception: 处理远程登录时遇到错误。
---> System.Exception: Correlation failed.
--- End of inner exception stack trace ---
at Microsoft.AspNetCore.Authentication.RemoteAuthenticationHandler`1.HandleRequestAsync()
at Microsoft.AspNetCore.Authentication.AuthenticationMiddleware.Invoke(HttpContext context)
at Microsoft.AspNetCore.Diagnostics.DeveloperExceptionPageMiddleware.Invoke(HttpContext context)

常见解决步骤 #

• 确保回调地址完全匹配
  在Google Cloud控制台的OAuth 2.0客户端ID设置里，回调地址必须和部署后应用的地址完全一致，包括http/https、域名、端口（非默认需指定）。比如本地测试用http://localhost:5000/signin-google，线上要换成https://yourdomain.com/signin-google。

• 启用HTTPS并配置Cookie安全策略
  部署环境必须用HTTPS，因为Google Auth的Correlation Cookie默认带Secure属性（仅HTTPS传输），HTTP环境下无法正确传递Cookie导致关联失败。同时在Program.cs中配置Cookie：

  builder.Services.Configure<CookiePolicyOptions>(options =>
  {
      options.MinimumSameSitePolicy = SameSiteMode.Lax;
      options.Secure = CookieSecurePolicy.Always; // 生产环境强制HTTPS
  });
  

• 配置Correlation Cookie的域和路径
  若应用部署在子域名下，需显式配置Correlation Cookie的域，避免跨域问题。配置Google Auth时添加：

  builder.Services.AddAuthentication().AddGoogle(options =>
  {
      options.ClientId = "your-client-id";
      options.ClientSecret = "your-client-secret";
      options.CorrelationCookie.Domain = "yourdomain.com"; // 根域名适配子域名场景
      options.CorrelationCookie.Path = "/";
  });
  

• 检查服务器时间同步
  Correlation Cookie有过期时间，若服务器本地时间与Google服务器时间偏差过大，会导致Cookie提前失效引发关联失败。需确保服务器时间和NTP服务器同步。

• 清除浏览器缓存和Cookie
  浏览器缓存的旧Cookie可能引发冲突，让用户清除对应域名的Cookie后重新尝试登录。

• 检查反向代理配置（若使用）
  若应用部署在Nginx、IIS等反向代理后，需确保代理正确传递X-Forwarded-Proto和X-Forwarded-For头，让Asp.NET识别正确的请求地址。比如Nginx配置：

  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Forwarded-For $remote_addr;
  

  同时在Asp.NET中启用转发头支持：

  app.UseForwardedHeaders(new ForwardedHeadersOptions
  {
      ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
  });
  

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