升级至pac4j v5后的中央登出行为配置问题咨询

云上老周

2026-6-25

解决方案：pac4j v5 替代原LogoutFilter的登出配置

在pac4j v5版本中，原LogoutFilter的配置方式已重构，需通过LogoutActionBuilder封装登出逻辑后，注入到新的LogoutFilter构造中。以下是与你原有配置完全等效的实现：

1. 配置自定义LogoutActionBuilder

@SuppressWarnings("unchecked")
@Bean
public LogoutActionBuilder logoutActionBuilder() {
    DefaultLogoutActionBuilder builder = new DefaultLogoutActionBuilder(pac4jDefaultConfig(), myLogoutLogic());
    builder.setDefaultUrl("/login?logout");
    builder.setLocalLogout(true);
    builder.setCentralLogout(true);
    builder.setSuffix("logout");
    return builder;
}

2. 配置新的LogoutFilter实例

@Bean
public LogoutFilter pac4jCentralLogoutFilter(LogoutActionBuilder logoutActionBuilder) {
    return new LogoutFilter(logoutActionBuilder, new SpringMvcHttpActionAdapter());
}

3. 针对SAML SLO的适配说明

根据v5发布说明，SAML中央登出默认不再触发本地登出，需显式启用：

上述配置中setLocalLogout(true)已确保触发中央登出时同步执行本地登出，与你原有逻辑完全一致。
若需处理IDP发起的登出请求（SLO回调），需确保SAML客户端已正确配置回调路径，且该路径被pac4j过滤器链覆盖，回调逻辑会自动触发本地登出。

新旧配置参数对应表

原LogoutFilter方法	新LogoutActionBuilder方法	作用说明
`setConfig(...)`	构造函数传入	绑定pac4j核心配置
`setDefaultUrl(...)`	`setDefaultUrl(...)`	登出后跳转的默认URL
`setLocalLogout(true)`	`setLocalLogout(true)`	启用本地会话登出
`setCentralLogout(true)`	`setCentralLogout(true)`	启用中央IDP登出（如SAML SLO）
`setSuffix(...)`	`setSuffix(...)`	登出请求的路径后缀
`setLogoutLogic(...)`	构造函数传入	绑定自定义登出逻辑