如何在@WithMockUser注解中读取枚举、字符串常量及常量列表的值？

问题根因 #

Java注解的属性值必须是编译期常量，你之前调用name()方法属于运行期求值，编译阶段无法确定值，所以语法不生效。另外注意@WithMockUser的roles属性会自动为传入值拼接ROLE_前缀，如果你的枚举值本身已经携带该前缀，应该使用authorities属性避免重复拼接。

方案1：枚举内预定义编译期常量（最简单通用） #

直接在枚举中定义对应字符串字面量的常量，保证编译期可见，同时支持单个值和数组传入：

public enum RoleEnum {
    ROLE_ADMIN,
    ROLE_MODERATOR,
    ROLE_USER;

    // 单个角色编译期常量
    public static final String ADMIN = "ROLE_ADMIN";
    public static final String MODERATOR = "ROLE_MODERATOR";
    public static final String USER = "ROLE_USER";

    // 角色分组常量
    public static final String[] X_ROLE_GROUP = {ADMIN, MODERATOR};
}

使用示例 #

• 单个角色传入：

@WithMockUser(authorities = RoleEnum.ADMIN)
@Test
public void testAdminAccess() {
    // 测试逻辑
}

• 角色分组传入：

@WithMockUser(authorities = RoleEnum.X_ROLE_GROUP)
@Test
public void testGroupAccess() {
    // 测试管理员、版主均可访问的逻辑
}

如果担心常量和枚举值不一致，可以补充单测做一致性校验：

@Test
public void checkRoleConstantMatch() {
    assertEquals(RoleEnum.ROLE_ADMIN.name(), RoleEnum.ADMIN);
    assertEquals(RoleEnum.ROLE_MODERATOR.name(), RoleEnum.MODERATOR);
    assertEquals(RoleEnum.ROLE_USER.name(), RoleEnum.USER);
}

方案2：自定义注解支持直接传枚举（适合批量使用场景） #

如果不想在枚举中重复定义字符串常量，可以自定义复合注解搭配测试监听器实现直接传枚举值：

1. 自定义注解

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface WithMockEnumRole {
    RoleEnum[] value() default {};
    String username() default "test";
}

2. 自定义测试执行监听器，解析注解并注入权限

public class WithMockEnumRoleListener implements TestExecutionListener {
    @Override
    public void beforeTestMethod(TestContext testContext) throws Exception {
        WithMockEnumRole annotation = testContext.getTestMethod().getAnnotation(WithMockEnumRole.class);
        if (annotation == null) return;
        // 转换枚举为权限字符串
        List<GrantedAuthority> authorities = Arrays.stream(annotation.value())
                .map(role -> new SimpleGrantedAuthority(role.name()))
                .toList();
        // 注入安全上下文
        SecurityContextHolder.getContext().setAuthentication(
                new UsernamePasswordAuthenticationToken(annotation.username(), null, authorities)
        );
    }
}

3. 测试类中启用监听器即可直接传枚举

@SpringBootTest
@TestExecutionListeners(listeners = WithMockEnumRoleListener.class, mergeMode = MERGE_WITH_DEFAULTS)
public class RoleTest {
    @Test
    @WithMockEnumRole(RoleEnum.ROLE_ADMIN)
    public void testAdminAccess() {
        // 测试逻辑
    }

    @Test
    @WithMockEnumRole({RoleEnum.ROLE_ADMIN, RoleEnum.ROLE_MODERATOR})
    public void testGroupAccess() {
        // 测试逻辑
    }
}

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