Spring OAuth授权服务器无法自定义元数据及修改URL问题

一、自定义配置不生效的原因及修正 #

1. 错误调用build()方法 #

你的代码中在authorizationServerMetadataCustomizer回调里调用了.build()，这会导致你修改的OAuth2AuthorizationServerMetadata.Builder实例被丢弃，框架最终使用的是未修改的默认实例。必须移除build()调用，自定义器只需修改Builder的属性，框架会自动完成构建。

2. 变量赋值可能存在问题 #

确保authorizationEndpoint、tokenEndpoint等变量已正确赋值为你期望的端点路径（可以是完整URL，或相对于issuer的路径），同时scopesSupported等集合已初始化并包含预期的权限范围。

3. issuer配置错误 #

dispatcherServletPath.path通常仅返回Servlet的基础路径（比如/），无法作为有效的issuer值，需要设置完整的issuer URL（如http://localhost:8080/auth）。

二、修正后的配置示例 #

以下是修正后的authorizationServerMetadataEndpoint配置片段：

.authorizationServerMetadataEndpoint { authorizationServerMetadataEndpoint ->
    authorizationServerMetadataEndpoint.authorizationServerMetadataCustomizer { builder ->
        builder
            .authorizationEndpoint("http://localhost:8080/auth/oauth2/authorize")
            .tokenEndpoint("http://localhost:8080/auth/oauth2/token")
            .clientRegistrationEndpoint("http://localhost:8080/auth/oauth2/register")
            .issuer("http://localhost:8080/auth")
            .responseType("code")
            .responseType("token") // 添加自定义响应类型
            .scope("read")
            .scope("write") // 添加自定义权限范围
            .tokenIntrospectionEndpoint("http://localhost:8080/auth/oauth2/introspect")
            .tokenRevocationEndpoint("http://localhost:8080/auth/oauth2/revoke")
        // 移除.build()调用
    }
}

三、修改元数据访问URL #

要修改.well-known/oauth-authorization-server的默认路径，只需在authorizationServerMetadataEndpoint配置块中调用endpointUri()方法，指定自定义路径即可：

.authorizationServerMetadataEndpoint { metadataEndpoint ->
    metadataEndpoint
        // 设置自定义元数据访问路径
        .endpointUri("/.well-known/custom-oauth-authorization-server")
        .authorizationServerMetadataCustomizer { builder ->
            // 自定义元数据属性...
        }
}

四、额外检查 #

• 确保SecurityFilterChain的securityMatcher包含你自定义的元数据端点路径，否则请求会被其他过滤器链拦截。
• 验证所有自定义的端点路径在授权服务器配置中已正确注册（比如authorizationEndpoint的路径是否与你在authorizationEndpoint配置块中设置的一致）。

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