Spring Boot OAuth2资源服务器JwtDecoder初始化失败求助

核心问题定位 #

异常根因是JwtDecoder自动发现颁发者配置时，请求http://localhost:8080返回了text/html类型响应，而默认的消息转换器无法解析该类型内容。以下是针对性解决思路：

1. 确认颁发者OIDC配置端点正确性 #

• 直接访问颁发者的标准OIDC配置端点http://localhost:8080/.well-known/openid-configuration，检查返回内容是否为标准JSON格式的OIDC元数据。如果访问根路径http://localhost:8080返回的是HTML页面（比如系统首页），说明你配置的颁发者地址有误，应该指向授权服务器的OIDC配置根路径，而非Web页面路径。
• 核实授权服务器是否正确开启了OIDC配置端点，避免因配置缺失导致返回HTML页面。

2. 绕过自动发现，手动指定JWKS端点 #

如果颁发者的OIDC自动发现机制存在问题，可直接配置JWT密钥集（JWKS）的URI，跳过OIDC配置请求：

spring:
  security:
    oauth2:
      resourceserver:
        jwt:
          jwk-set-uri: http://localhost:8080/oauth2/jwks

此配置让JwtDecoder直接从指定JWKS端点获取密钥，无需先请求OIDC配置，彻底规避HTML响应解析问题。

3. 正确注入自定义RestTemplate到JwtDecoder #

自定义RestTemplate时，必须确保它被JwtDecoder实例使用，而非仅定义Bean：

@Bean
public JwtDecoder jwtDecoder() {
    RestTemplate restTemplate = new RestTemplate();
    // 为转换器添加text/html类型支持，强制解析为JSON
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
    converter.setSupportedMediaTypes(Arrays.asList(MediaType.APPLICATION_JSON, MediaType.TEXT_HTML));
    restTemplate.getMessageConverters().add(0, converter);

    return JwtDecoders.fromIssuerLocation("http://localhost:8080")
            .restOperations(restTemplate)
            .build();
}

注意要通过restOperations()方法将自定义RestTemplate绑定到JwtDecoder，覆盖默认实例。

4. 修正授权服务器响应Content-Type #

如果授权服务器的OIDC配置端点确实返回text/html类型，需要调整授权服务器配置，确保端点返回application/json类型：

• 检查授权服务器的拦截器、过滤器，避免它们修改了响应的Content-Type。
• 确认Spring Security授权服务器的端点配置，确保OIDC元数据端点的响应类型正确。

5. 排查全局拦截/过滤逻辑干扰 #

检查资源服务器或授权服务器中是否存在全局拦截器、过滤器，它们可能篡改了HTTP请求的响应类型。比如某些全局过滤器会强制将所有响应设置为text/html，这会直接破坏OIDC配置的JSON响应。

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