使用Saml2RedirectAuthenticationRequest生成重定向时遇samlRequest为空错误

出现java.lang.IllegalArgumentException: samlRequest cannot be null or empty错误，本质是你传入的RelyingPartyRegistration实例缺少生成SAML认证请求所需的核心配置，导致框架无法构建出有效的samlRequest参数。

解决方案步骤： #

• 确保RelyingPartyRegistration配置完整
  必须在依赖方注册中配置SP（服务提供者）和IDP（身份提供者）的核心属性，示例配置如下：

  @Bean
  public RelyingPartyRegistrationRepository relyingPartyRegistrationRepository() {
      // 构建服务提供者配置
      RelyingPartyRegistration registration = RelyingPartyRegistration.withRegistrationId("your-sp-reg-id")
              // SP自身的实体ID
              .entityId("https://your-app-domain.com/saml2/service-provider-metadata")
              // SAML响应接收端点（必须和IDP配置的一致）
              .assertionConsumerServiceLocation("https://your-app-domain.com/login/saml2/sso/your-sp-reg-id")
              // IDP的实体ID
              .idpEntityId("https://idp-domain.com/idp/entity-id")
              // IDP的单点登录跳转端点
              .singleSignOnServiceLocation("https://idp-domain.com/idp/saml2/sso")
              // 如果需要对认证请求签名，配置签名密钥（可选，但部分IDP要求）
              .signingX509Credentials(credentials -> credentials.add(
                      Saml2X509Credential.signing(new KeyStoreKeyFactory(
                              new ClassPathResource("your-signing-keystore.jks"),
                              "keystore-password".toCharArray()
                      ).getKey("key-alias", "key-password".toCharArray()))
              ))
              .build();
  
      return new InMemoryRelyingPartyRegistrationRepository(registration);
  }
  

• 校验传入的RelyingPartyRegistration实例
  构建认证请求前，确保传入的relyingPartyRegsitration不是null，且核心字段已正确初始化：

  if (relyingPartyRegsitration == null || relyingPartyRegsitration.getEntityId() == null) {
      throw new IllegalStateException("无效的RelyingPartyRegistration配置");
  }
  

• 简化重定向URL生成逻辑
  框架生成的getAuthenticationRequestUri()已经处理了URL编码，无需额外通过URI.create()转码，直接使用即可：

  Saml2RedirectAuthenticationRequest authnRequest = Saml2RedirectAuthenticationRequest
          .withRelyingPartyRegistration(relyingPartyRegsitration)
          .relayState(relayState)
          .build();
  
  // 直接使用框架生成的完整重定向URL
  response.sendRedirect(authnRequest.getAuthenticationRequestUri().toString());
  

• 排查自定义逻辑干扰
  检查是否有自定义过滤器、拦截器或处理器修改了RelyingPartyRegistration的属性，导致IDP端点、实体ID等核心参数被清空。

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