新SAML库Relay State配置及SSO登录跳转问题咨询

一、RelayState配置正确性确认 #

你当前的配置方向是正确的，这是Spring Security SAML2（基于OpenSaml4）中自定义RelayState的标准方式：

1. 通过OpenSaml4AuthenticationRequestResolver设置relayStateResolver，替代了旧版SAML扩展库中通过SAMLMessageContext设置RelayState的逻辑。
2. 自定义的relayStateResolver通过HttpServletRequest生成目标JSP路径，只要路径正确，登录成功后（IDP返回断言并通过assertionConsumerServiceLocation处理后），Spring Security会自动读取RelayState并完成跳转。

需要注意的细节：

• RelayState建议使用应用内相对路径（如/target-page.jsp），避免硬编码绝对URL，适配不同部署环境的context path。
• 必须确保这个Saml2AuthenticationRequestResolver被正确注册到Spring Security的过滤器链中，示例配置如下：

@Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
    http
        .saml2Login(saml2 -> saml2
            .authenticationRequestResolver(authenticationRequestResolver(registrationResolver()))
        );
    return http.build();
}

• 确认IDP侧配置允许传递并返回RelayState参数，部分IDP会默认丢弃自定义RelayState，需要在IDP后台开启相关配置。

二、NoSuchMethodError错误解决 #

你遇到的错误是OpenSAML版本不兼容导致的：

• Spring Security SAML2的OpenSaml4集成要求使用OpenSAML 4.x版本，该版本中AuthnRequest.setIssueInstant方法的参数类型为java.time.Instant。
• 若项目中混入了OpenSAML 3.x版本，该版本的setIssueInstant接受的是java.util.Date类型，就会触发NoSuchMethodError。

修复步骤：

1. 确保项目依赖的OpenSAML版本与Spring Security版本匹配（例如Spring Security 5.7.x对应OpenSAML 4.1.1）。
2. 排查并排除项目中所有旧版OpenSAML依赖（如opensaml-core、opensaml-saml-api等3.x版本）。
3. 配置Shibboleth制品仓库获取正确的OpenSAML 4.x依赖，Maven示例配置：

<repositories>
    <repository>
        <id>shibboleth-releases</id>
        <url>https://build.shibboleth.net/nexus/content/repositories/releases/</url>
    </repository>
</repositories>

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