SecurityContextHolder mock跨测试类残留，@DirtiesContext无效如何解决？

问题根源其实很明确：SecurityContextHolder默认使用ThreadLocal存储上下文，而JUnit（不管是4还是5）的测试线程可能会被复用，前一个测试留下的ThreadLocal值不会自动清除。而你用的@DirtiesContext是用来重置Spring应用上下文的，它管不到ThreadLocal里的内容，所以这个注解对你的问题起不到作用。

下面是几个靠谱的解决方案，按从简单到全局的顺序推荐：

1. 每个测试类添加清理方法（最直接） #

在每个涉及SecurityContext的测试类中，添加@AfterEach（JUnit 5）或@After（JUnit 4）方法，手动清空SecurityContextHolder：

import org.junit.jupiter.api.AfterEach;
import org.springframework.security.core.context.SecurityContextHolder;

class YourTestClass {
    // ... 你的测试代码 ...

    @AfterEach
    void cleanUpSecurityContext() {
        // 清空当前线程的SecurityContext
        SecurityContextHolder.clearContext();
    }
}

这个方法简单直接，确保每个测试结束后都清理掉残留的mock对象，不会影响下一个测试。

2. 自定义JUnit扩展实现全局清理（避免重复代码） #

如果有很多测试类都需要处理这个问题，写重复的清理方法太麻烦，可以自定义一个JUnit扩展，全局处理SecurityContext的清理：

import org.junit.jupiter.api.extension.AfterTestExecutionCallback;
import org.junit.jupiter.api.extension.ExtensionContext;
import org.springframework.security.core.context.SecurityContextHolder;

public class SecurityContextCleanupExtension implements AfterTestExecutionCallback {
    @Override
    public void afterTestExecution(ExtensionContext context) {
        SecurityContextHolder.clearContext();
    }
}

然后在测试类上添加@ExtendWith注解启用这个扩展：

import org.junit.jupiter.api.extension.ExtendWith;

@ExtendWith(SecurityContextCleanupExtension.class)
class YourTestClass {
    // ... 测试代码 ...
}

如果是Spring Boot项目，还可以把这个扩展配置到全局，让所有测试自动生效：在src/test/resources/META-INF/services/org.junit.jupiter.api.extension.Extension文件中添加你的扩展全类名即可。

3. 结合Spring Security Test的原生支持 #

如果你使用Spring Security Test模块，其实它的注解（比如@WithMockUser、@WithAnonymousUser）会自动在测试前后清理SecurityContext。如果你的测试场景可以用这些注解替代手动mock SecurityContext，那会更省心，也能避免手动管理上下文的问题。

举个例子，用@WithMockUser替代手动mock：

import org.springframework.security.test.context.support.WithMockUser;
import org.junit.jupiter.api.Test;

class YourTestClass {
    @Test
    @WithMockUser(username = "testUser", roles = "USER")
    void testWithMockUser() {
        // 这里的SecurityContext会自动注入mock用户，测试后自动清理
    }
}

额外提醒 #

• 如果你开启了JUnit的并行测试（比如JUnit 5的junit.jupiter.execution.parallel.enabled=true），ThreadLocal的问题可能会更突出，这时候全局扩展的方案会更可靠。
• 不要依赖@DirtiesContext处理这类ThreadLocal级别的状态，它的职责是重置Spring上下文，和线程本地存储无关。

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