Keycloak 25自定义LoginFormsProvider遇空指针异常，求解决方案

Keycloak 25仍支持通过SPI扩展或替换FreeMarkerLoginFormsProvider，你遇到的空指针问题是SPI配置错误+工厂类实现不完整导致的，以下是具体解决方案：

1. 修正SPI启动参数 #

你之前使用的--spi-login-provider参数类别错误，LoginFormsProvider对应的SPI类型是login-forms，而非login。正确启动参数应为：

--spi-login-forms-provider=custom-login-provider
--spi-login-forms-custom-login-provider-enabled=true

错误的参数会导致Keycloak无法定位到你的自定义提供者，进而调用getProvider时返回null，触发空指针异常。

2. 完善自定义工厂类实现 #

继承FreeMarkerLoginFormsProviderFactory时，必须调用父类的init和postInit方法，否则会导致父类关键资源（如FreeMarker模板加载器）初始化失败，引发依赖缺失：

public class CustomLoginFormsProviderFactory extends FreeMarkerLoginFormsProviderFactory {
    public static final String PROVIDER_ID = "custom-login-provider";

    @Override
    public LoginFormsProvider create(KeycloakSession session) {
        return new CustomLoginFormsProvider(session);
    }

    @Override
    public String getId() {
        return PROVIDER_ID;
    }

    @Override
    public void init(Config.Scope config) {
        super.init(config); // 必须调用父类初始化逻辑
    }

    @Override
    public void postInit(KeycloakSessionFactory factory) {
        super.postInit(factory); // 必须调用父类后初始化逻辑
    }
}

3. 校验META-INF配置文件 #

确保META-INF/services/org.keycloak.forms.login.LoginFormsProviderFactory文件内容为自定义工厂类的全限定类名，例如：

com.yourcompany.keycloak.spi.CustomLoginFormsProviderFactory

文件路径、名称和类名必须完全匹配，否则Keycloak无法自动发现你的自定义提供者。

4. 临时Workaround（若上述方案仍有问题） #

可通过自定义AuthenticationFlow中的Authenticator间接修改登录表单：在Authenticator的render方法中，直接操作LoginFormsProvider的模板参数或替换模板路径，避免直接替换整个LoginFormsProvider实例。

内容的提问来源于stack exchange，提问作者Georgi D.