Pac4j-Play框架下自定义HttpErrorHandler无法加载401/403视图问题

问题核心是Pac4j的权限拦截逻辑会优先于Play的HttpErrorHandler处理401/403状态码，直接通过PlayHttpActionAdapter生成响应，不会走到你自定义的错误处理器。要解决这个问题，需要自定义Pac4j的PlayHttpActionAdapter，让它调用你的CustomHttpErrorHandler来生成带自定义视图的响应。

步骤1：实现自定义PlayHttpActionAdapter #

重写PlayHttpActionAdapter，在处理401/403时调用你的错误处理器，同时从Pac4j的上下文里获取RequestHeader参数：

import org.pac4j.core.context.WebContext;
import org.pac4j.core.exception.HttpAction;
import org.pac4j.play.http.PlayHttpActionAdapter;
import org.pac4j.play.context.PlayWebContext;
import play.mvc.Http;
import play.mvc.Result;
import javax.inject.Inject;
import java.util.concurrent.CompletionStage;

public class CustomPlayHttpActionAdapter extends PlayHttpActionAdapter {

    private final CustomHttpErrorHandler customErrorHandler;

    // 通过Play的依赖注入注入你的自定义错误处理器
    @Inject
    public CustomPlayHttpActionAdapter(CustomHttpErrorHandler customErrorHandler) {
        this.customErrorHandler = customErrorHandler;
    }

    @Override
    public CompletionStage<Result> adapt(HttpAction action, WebContext webContext) {
        PlayWebContext playWebContext = (PlayWebContext) webContext;
        Http.RequestHeader requestHeader = playWebContext.getRequestHeader();
        int statusCode = action.getCode();

        // 针对401/403调用自定义错误处理器的方法
        if (statusCode == 401) {
            return customErrorHandler.onUnauthorized(requestHeader, "未授权访问");
        } else if (statusCode == 403) {
            return customErrorHandler.onForbidden(requestHeader, "权限不足");
        }

        // 其他状态码沿用Pac4j默认处理逻辑
        return super.adapt(action, webContext);
    }
}

步骤2：绑定自定义Adapter到Play的DI容器 #

创建一个Play模块类，将自定义Adapter绑定为PlayHttpActionAdapter的实现类：

import org.pac4j.play.http.PlayHttpActionAdapter;
import play.inject.Binding;
import play.inject.Module;
import java.util.List;

public class SecurityModule extends Module {
    @Override
    public List<Binding<?>> bindings() {
        return List.of(
                // 绑定自定义Adapter，替换默认的INSTANCE
                bind(PlayHttpActionAdapter.class).to(CustomPlayHttpActionAdapter.class).eagerly()
        );
    }
}

步骤3：启用自定义模块 #

在application.conf中添加配置，启用你的SecurityModule：

play.modules.enabled += "com.yourpackage.SecurityModule"

关键说明 #

• Pac4j在触发权限拦截时，会抛出HttpAction异常，由PlayHttpActionAdapter处理并生成响应。默认的Adapter仅返回简单的状态码响应，不会触发Play的HttpErrorHandler。
• 自定义Adapter通过PlayWebContext获取到RequestHeader，再调用你已经实现好的onUnauthorized和onForbidden方法，确保自定义视图能获取到所需的请求参数。
• 确保你的CustomHttpErrorHandler是被Play依赖注入管理的（比如添加@Inject注解），这样自定义Adapter才能正确注入它。

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