Keycloak自定义主题：如何默认展示起始页及读取URL参数

嘿，我来帮你梳理几个可行的解决思路，都是实际项目里验证过的：

一、直接改主题配置（最省心的方案） #

首先你得找找自定义主题里的配置文件，比如theme.properties或者专门的路由配置项，一般这类主题都会有个设置默认展示页面的参数。比如原来可能配的是default.view=/login.ftl，你直接把它改成起始页的路径，比如default.view=/home.ftl，这样访问my-site/auth的时候就会默认加载你的起始页了。

二、扩展服务端点来控制跳转 #

如果主题配置没法直接改，那可以自己写个自定义的入口端点来处理逻辑：

1. 写一个继承自框架默认入口点的类，重写commence方法（思路适用于多数Java后端框架）。
2. 在方法里判断请求参数，如果没有指定页面参数，就重定向到起始页；有参数的话再跳对应页面。
   代码示例大概是这样：

public class CustomAuthEntryPoint extends DefaultAuthEntryPoint {
    @Override
    public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException {
        String targetPage = request.getParameter("page");
        if (targetPage == null || targetPage.trim().isEmpty()) {
            // 默认跳起始页
            response.sendRedirect(request.getContextPath() + "/auth/home");
        } else {
            // 按参数跳对应页面
            response.sendRedirect(request.getContextPath() + "/auth/" + targetPage);
        }
    }
}

然后记得在框架配置里把默认的入口点换成你这个自定义类就行。

三、让FTL模板能拿到URL参数 #

你之前说FTL里拿不到参数，大概率是模板上下文没暴露request对象。试试在FTL里这么写：

<#assign targetPage = request.getParameter("page")>
<#if targetPage == "login">
    <#include "login.ftl">
<#elseif targetPage == "register">
    <#include "register.ftl">
<#else>
    <#include "home.ftl">
</#if>

要是还不行，就得在后端把request对象放到模板的模型里，比如：

modelAndView.addObject("request", request);

这样模板里就能直接用request.getParameter()获取参数了。

四、部署层面反向代理调整 #

如果前面的方法都不太方便，也可以在反向代理（比如Nginx/Apache）里做配置。比如Nginx里这么写：

location /auth {
    try_files $uri $uri/ /auth/home;
}

这样访问my-site/auth时会默认转发到起始页路径，用户访问/auth/login或/auth/register时正常跳转对应页面。

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