CAS 6.6.6自定义登录WebFlow：替换默认仪表板为自定义JSP视图

一、Java配置自定义WebFlow与视图解析（CAS 6.6.x推荐方式） #

CAS 6.6.x采用Spring WebFlow的Java配置体系，需覆盖默认登录流逻辑并注册自定义视图解析器：

1. 自定义WebFlow配置类 #

创建配置类继承CasWebflowConfiguration，替换默认的着陆页状态：

package com.yourorg.cas.config;

import org.apereo.cas.web.flow.CasWebflowConfiguration;
import org.apereo.cas.web.flow.CasWebflowConstants;
import org.springframework.context.annotation.Configuration;
import org.springframework.webflow.definition.registry.FlowDefinitionRegistry;
import org.springframework.webflow.engine.ActionState;
import org.springframework.webflow.engine.Flow;
import org.springframework.webflow.engine.ViewState;
import org.springframework.webflow.engine.builder.support.FlowBuilderServices;

@Configuration("customWebflowConfig")
public class CustomWebflowConfig extends CasWebflowConfiguration {

    @Override
    protected void doInitializeLoginFlowBuilder(final Flow flow, final FlowBuilderServices flowBuilderServices, final FlowDefinitionRegistry flowDefinitionRegistry) {
        super.doInitializeLoginFlowBuilder(flow, flowBuilderServices, flowDefinitionRegistry);
        
        // 移除默认着陆页状态
        flow.removeState(CasWebflowConstants.STATE_ID_LANDING_VIEW);
        
        // 添加自定义着陆页视图状态，关联自定义视图名"customLanding"
        final ViewState customLandingView = new ViewState(flow, CasWebflowConstants.STATE_ID_LANDING_VIEW, 
            flowBuilderServices.getViewFactoryCreator().createViewFactory("customLanding"));
        customLandingView.getEntryActionList().add(createEvaluateAction("initialFlowSetupAction"));
        
        // 调整流程起始跳转逻辑，确保无服务时进入自定义视图
        final ActionState startState = (ActionState) flow.getState(CasWebflowConstants.STATE_ID_START);
        startState.getTransitionSet().remove(CasWebflowConstants.TRANSITION_ID_SUCCESS);
        startState.getTransitionSet().add(createTransition(CasWebflowConstants.TRANSITION_ID_SUCCESS, CasWebflowConstants.STATE_ID_LANDING_VIEW));
    }
}

2. 注册自定义视图解析器 #

创建配置类指定自定义JSP的存储路径（示例路径为src/main/resources/custom-views/）：

package com.yourorg.cas.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.view.InternalResourceViewResolver;

@Configuration
public class ViewResolverConfig {

    @Bean
    public InternalResourceViewResolver customViewResolver() {
        final InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("classpath:/custom-views/");
        resolver.setSuffix(".jsp");
        resolver.setOrder(1); // 优先级高于CAS默认视图解析器
        return resolver;
    }
}

3. 编写自定义JSP视图 #

在src/main/resources/custom-views/下创建customLanding.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>自定义CAS着陆页</title>
</head>
<body>
    <h1>欢迎访问自定义登录入口</h1>
    <div>
        <a href="/cas/login?service=https://your-service.example.com">登录到XX业务系统</a>
    </div>
</body>
</html>

二、CAS核心属性配置 #

在application.properties中添加以下配置，禁用默认仪表板并指定自定义着陆视图：

# 关闭默认服务仪表板
cas.view.dashboard.enabled=false
# 指定无服务时的默认视图名（与自定义ViewState中的名称一致）
cas.webflow.landing-view=customLanding

三、可选：XML配置方案（CAS 6.6.x不推荐但可兼容） #

若坚持使用XML配置，需覆盖默认登录流文件：

1. 创建src/main/resources/webflow/login/custom-login-flow.xml，复制CAS默认登录流内容后，替换<view-state id="landingView">节点：

<view-state id="landingView" view="customLanding">
    <entry-actions>
        <evaluate expression="initialFlowSetupAction" />
    </entry-actions>
</view-state>

2. 在application.properties中指定自定义WebFlow路径：

cas.webflow.login.flow.location=classpath:/webflow/login/custom-login-flow.xml

四、常见问题排查 #

• 确认自定义配置类的包路径被CAS组件扫描覆盖，可通过@ComponentScan手动指定扫描范围
• 检查视图解析器的order属性，确保优先级高于默认解析器，避免找不到自定义JSP
• 查看CAS DEBUG级别日志，跟踪WebFlow状态跳转逻辑，确认是否存在视图加载失败的报错
• 验证cas.webflow.landing-view属性值与自定义视图名完全一致

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