Jakarta EE 8自定义表单认证：登录成功却返回SEND_CONTINUE问题

我之前在Jakarta EE 8 + WildFly 21 + Java 11的环境里也碰到过一模一样的问题，折腾了好一阵子才搞清楚原因。咱们先拆解下问题本质，再给几个靠谱的解决办法：

为什么会返回SEND_CONTINUE？ #

WildFly 21在处理Jakarta EE 8的SecurityContext.authenticate()表单认证流程时，有个特定的实现逻辑：当用户名密码验证通过后，容器需要先完成会话同步、身份凭证Cookie写入这些内部操作，这时候它会返回AuthenticationStatus.SEND_CONTINUE，而不是直接返回SUCCESS。这个状态是在告诉应用：“我还没做完后续的认证收尾工作，先别自己跳，等我处理完”。

偶尔返回SUCCESS的情况，大概率是容器内部操作刚好在当前请求周期内完成了，属于随机的边缘情况，没法稳定依赖。

正确的解决办法 #

1. 在Login托管Bean里正确处理SEND_CONTINUE状态 #

不要执着于一定要拿到SUCCESS才跳转，而是根据状态做分支处理：

• 拿到SUCCESS时，执行你的自定义重定向逻辑
• 拿到SEND_CONTINUE时，直接返回null，让容器自己完成后续的跳转流程

示例代码：

@Named
@RequestScoped
public class LoginBean {
    @Inject
    private SecurityContext securityContext;
    @Inject
    private HttpServletRequest request;
    @Inject
    private HttpServletResponse response;
    private String username;
    private String password;

    public String login() {
        AuthenticationStatus status = securityContext.authenticate(
            request,
            response,
            AuthenticationParameters.withParams()
                .credential(new UsernamePasswordCredential(username, password))
                .newAuthentication(true)
        );

        if (status == AuthenticationStatus.SUCCESS) {
            // 自定义重定向，记得加faces-redirect=true触发客户端跳转
            return "/start.xhtml?faces-redirect=true";
        } else if (status == AuthenticationStatus.SEND_CONTINUE) {
            // 交给容器处理后续的认证收尾和跳转，不要返回自定义路径
            return null;
        } else {
            // 认证失败，添加错误提示
            FacesContext.getCurrentInstance().addMessage(null, 
                new FacesMessage(FacesMessage.SEVERITY_ERROR, "Invalid credentials", null));
            return null;
        }
    }

    // getter和setter省略
}

2. 在认证配置里指定成功跳转页 #

如果你不需要特别复杂的动态重定向逻辑，直接在CustomFormAuthenticationConfig里通过@LoginToContinue指定successPage，容器在处理SEND_CONTINUE时会自动跳转到这个页面：

@FormAuthenticationMechanismDefinition(
    loginToContinue = @LoginToContinue(
        loginPage = "/login.xhtml",
        successPage = "/start.xhtml", // 直接指定成功后的目标页
        errorPage = "/login.xhtml"
    )
)
@ApplicationScoped
public class CustomFormAuthenticationConfig implements HttpAuthenticationMechanism {
    // 你的认证逻辑实现，比如调用UserAuthenticator验证凭证
    @Override
    public AuthenticationStatus validateRequest(HttpServletRequest request, 
                                               HttpServletResponse response, 
                                               HttpMessageContext context) throws AuthenticationException {
        // 省略验证逻辑
    }
}

3. 检查WildFly的会话配置 #

有时候会话同步延迟也会导致SEND_CONTINUE频繁出现，可以调整standalone.xml里Undertow子系统的会话设置，确保Cookie和会话同步正常：

<subsystem xmlns="urn:jboss:domain:undertow:11.0">
    <server name="default-server">
        <host name="default-host" alias="localhost">
            <session-config>
                <session-timeout>30</session-timeout>
                <cookie name="JSESSIONID" http-only="true" secure="${jboss.http.secure.cookie:false}"/>
            </session-config>
        </host>
    </server>
</subsystem>

为什么临时改欢迎页能生效？ #

当容器返回SEND_CONTINUE后，如果没有指定成功跳转页，它会默认跳转到应用的欢迎页（也就是web.xml里<welcome-file-list>配置的页面）。你把欢迎页改成跳转start.xhtml的页面，相当于让容器帮你完成了跳转，但这只是绕过问题，不是根本解决——如果后续需要动态调整跳转目标，这个方案就不灵活了。

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