调试环境下Swagger UI中获取Token的AllowAnonymous失效问题

可能原因及解决方法 #

1. Swagger OIDC配置的相对路径解析问题 #

你的Swagger配置中，OpenIdConnect的配置使用了相对路径../../.well-known/openid-configuration：

c.AddSecurityDefinition(
    "Bearer",
    new OpenApiSecurityScheme
    {
        Type = SecuritySchemeType.OpenIdConnect,
        OpenIdConnectUrl = new Uri($"../../.well-known/openid-configuration", UriKind.Relative)
    });

本地运行时，项目根路径可能和同事或服务器环境存在差异，导致该相对路径无法正确指向OIDC配置文件，Swagger UI因此无法初始化Token请求的正确参数。

解决方法：

• 改用绝对路径测试，比如直接填写OIDC配置的完整URL（如http://localhost:xxxx/.well-known/openid-configuration），验证是否能正常调用Token接口。
• 确认本地项目的部署路径结构，调整相对路径层级，确保能正确解析到OIDC配置地址。

2. 本地环境网络/安全工具干扰 #

本地防火墙、杀毒软件、代理工具可能拦截了Swagger UI发起的Token请求，或者修改了请求头、路径信息。

解决方法：

• 临时关闭防火墙、杀毒软件，测试Swagger是否能正常请求Token。
• 检查本地代理设置，确保Swagger请求没有被代理转发到错误地址，尝试关闭代理后再测试。
• 打开浏览器开发者工具的Network面板，查看Token请求的实际URL、响应状态码和错误信息，确定是请求发送失败还是响应被拦截。

3. Swagger UI静态资源缓存问题 #

浏览器或本地部署的静态资源可能存在缓存，导致Swagger UI的最新配置未正确加载。

解决方法：

• 使用Ctrl+Shift+R强制刷新浏览器，或切换到无痕模式测试。
• 本地部署项目包时，清理部署目录的旧文件，确保最新的Swagger配置文件被加载。

4. 本地项目运行端口/路径差异 #

若你的本地项目运行端口或虚拟路径与同事不同，会导致Swagger生成的Token请求URL错误。

解决方法：

• 确认本地项目的运行端口和根路径，与同事保持一致；或在Swagger配置中动态获取当前项目的基础URL，替换相对路径。

代码层面验证 #

你的AuthenticationFilter仅在接口未标记AllowAnonymous时添加401响应，而获取Token的接口应带有AllowAnonymous属性，因此该过滤器不会影响Token请求的执行，可排除该代码的问题。

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