Spring与Jersey中借助JerseyConfig和@Profile隐藏REST端点的问题

我来给你分享几个更规范的方案，解决Spring + Jersey环境下基于运行时配置隐藏REST端点的问题，顺便帮你排查下用@Profile踩的坑：

直接在控制器里抛NotFoundException只是“伪隐藏”，更彻底的方式是让不符合运行时配置的端点根本不被Jersey注册。

你之前直接在控制器加@Profile没用，核心原因是：Jersey的ResourceConfig是独立管理资源注册的，不会自动识别Spring的@Profile规则。正确的做法是在ResourceConfig里根据当前激活的Profile动态注册控制器：

@Configuration
public class JerseyConfig extends ResourceConfig {
    private final Environment env;

    // 注入Spring环境对象，用来判断当前激活的Profile
    public JerseyConfig(Environment env) {
        this.env = env;
        
        // 注册所有环境都需要的公共端点
        register(CommonPublicController.class);
        
        // 根据运行时Profile注册特定端点
        if (env.acceptsProfiles(Profiles.of("prod"))) {
            register(ProdExclusiveController.class);
        } else if (env.acceptsProfiles(Profiles.of("dev", "test"))) {
            register(DevTestOnlyController.class);
        }
    }
}

这种方式下，不符合当前Profile的控制器完全不会被Jersey纳入端点列表，既不会暴露，也不会产生无效请求的错误日志，是性能最优的方案。

如果需要更灵活的控制（比如同一个控制器里的个别方法需要隐藏），可以借助Jersey的Feature和DynamicFeature接口，结合运行时配置实现精准拦截：

1. 先定义一个自定义注解，标记需要条件隐藏的方法：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface HideOnProd {}

2. 实现Jersey的DynamicFeature，根据配置决定是否拦截目标方法：

public class ConditionalEndpointFeature implements Feature {
    private final Environment env;

    public ConditionalEndpointFeature(Environment env) {
        this.env = env;
    }

    @Override
    public boolean configure(FeatureContext context) {
        context.register(new DynamicFeature() {
            @Override
            public void configure(ResourceInfo resourceInfo, FeatureContext context) {
                // 检查当前方法是否标记了@HideOnProd，且当前环境是prod
                if (resourceInfo.getResourceMethod().isAnnotationPresent(HideOnProd.class)
                    && env.acceptsProfiles(Profiles.of("prod"))) {
                    // 注册过滤器，直接返回404
                    context.register(NotFoundInterceptor.class);
                }
            }
        });
        return true;
    }
}

// 拦截请求并返回404的过滤器
public class NotFoundInterceptor implements ContainerRequestFilter {
    @Override
    public void filter(ContainerRequestContext requestContext) throws IOException {
        requestContext.abortWith(Response.status(Response.Status.NOT_FOUND).build());
    }
}

3. 最后在JerseyConfig里注册这个Feature：

@Configuration
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        register(ConditionalEndpointFeature.class);
        // 注册你的控制器
        register(YourController.class);
    }
}

这种方案适合需要对单个方法做精细化控制的场景，灵活性拉满。

你之前用@Profile报错，大概率是因为手动注册控制器和@Profile的逻辑冲突了——Spring因为Profile不匹配没创建控制器Bean，但Jersey还是尝试注册这个类，导致实例化失败。

要让@Profile真正生效，需要让Spring来管理Jersey资源的生命周期：

1. 给控制器添加@Component和@Profile注解：

@Component
@Profile("dev")
@Path("/dev-only")
public class DevOnlyController {
    @GET
    public String getDevDebugInfo() {
        return "dev debug data";
    }
}

2. 修改JerseyConfig，开启Spring组件扫描并注册Spring桥接器：

@Configuration
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        // 扫描你的控制器所在包
        packages("com.your.project.controllers");
        // 注册Spring组件提供者，让Jersey能识别Spring管理的Bean
        register(SpringComponentProvider.class);
    }
}

这样Spring会根据当前激活的Profile自动过滤控制器Bean，Jersey只会注册存在的Bean，自然就不会暴露不符合条件的端点了。

• 方案1：最彻底，性能最优，适合按环境隔离整个控制器的场景
• 方案2：最灵活，支持单个方法的条件隐藏，适合精细化需求
• 方案3：贴合Spring生态，适合已经大量使用Spring Profile的项目

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