Spring Security控制器测试中403错误排查与解决方案

在spring security的集成测试中，遇到http 403 forbidden错误是一个常见的问题。这通常意味着尽管您可能已经使用@withmockuser注解来模拟用户，但测试环境中的安全上下文与应用程序的实际安全配置之间存在不匹配。本教程将深入分析此类问题，并提供详细的排查与解决方案。

问题分析：Spring Security测试中的403错误根源

当您在Spring Security的控制器测试中收到403错误时，通常有以下几个核心原因：

1. 安全配置过于严格：在WebSecurityConfig中，您可能设置了类似anyRequest().hasRole("ADMIN")的规则，这意味着所有请求都必须由具有"ADMIN"角色的用户发起。
2. 模拟用户角色不匹配：尽管您使用了@WithMockUser(roles = ["ADMIN"])，但可能由于某种原因，安全上下文未能正确加载该角色，或者角色名称存在大小写等不一致。
3. 其他安全过滤器或授权机制：除了HTTP请求层面的授权，您的应用程序可能在服务层（例如使用@PreAuthorize）或其他自定义过滤器中也实现了授权逻辑，这些逻辑可能在测试中被触发。
4. CSRF配置的干扰（次要）：尽管示例中csrf().disable()，但如果CSRF是启用的，缺少CSRF令牌也会导致403。在禁用CSRF的情况下，这通常不是403的直接原因，但尝试添加.with(csrf())可能导致其他问题（如404），表明测试环境可能对CSRF配置有误解。

让我们结合提供的代码示例进行具体分析。

WebSecurityConfig 示例：

    fun filterChain(http: HttpSecurity): SecurityFilterChain {
        http
            .cors().and()
            .csrf().disable() // CSRF已禁用
            .authorizeRequests()
            .anyRequest().hasRole("ADMIN") // 所有请求需要ADMIN角色
            .and()
            .oauth2ResourceServer().jwt().jwtAuthenticationConverter(jwtAuthenticationConverter)
        return http.build()
    }

控制器测试示例：

    @Test
    @WithMockUser(roles = ["ADMIN"]) // 模拟ADMIN角色用户
    fun `testA`()  {
        mvc
            .perform(
                post("/bla/bla")
                    //.with(csrf()) // 尝试添加CSRF，但CSRF已禁用
                    .contentType(MediaType.APPLICATION_JSON)
            ).andExpect(status().isCreated)
    }

从上述代码可以看出，WebSecurityConfig明确要求所有请求都必须拥有ADMIN角色。同时，测试方法通过@WithMockUser(roles = ["ADMIN"])模拟了一个具有ADMIN角色的用户。理论上，这应该能够通过权限检查。然而，如果仍然出现403，则表明安全上下文在测试执行时未能如预期工作，或者存在其他未被发现的授权限制。

解决方案一：测试环境下临时放宽安全策略

对于集成测试，有时我们希望暂时绕过严格的身份验证和授权机制，以便专注于测试控制器本身的业务逻辑。这可以通过在测试配置中修改WebSecurityConfig来实现。

方法：使用@TestConfiguration或特定Profile

您可以为测试环境创建一个单独的WebSecurityConfig，或者在现有配置中使用Spring Profile来区分。最简单的方法是在测试类内部或单独的测试配置类中使用@TestConfiguration。

示例：在测试配置中放宽权限

首先，确保您的主应用程序的WebSecurityConfig保持不变。然后，创建一个专门用于测试的配置类：

import org.springframework.boot.test.context.TestConfiguration
import org.springframework.context.annotation.Bean
import org.springframework.security.config.annotation.web.builders.HttpSecurity
import org.springframework.security.web.SecurityFilterChain

@TestConfiguration // 标记为测试配置
class TestSecurityConfig {

    @Bean
    fun testFilterChain(http: HttpSecurity): SecurityFilterChain {
        http
            .cors().and()
            .csrf().disable() // 在测试中通常禁用CSRF
            .authorizeRequests()
            .anyRequest().permitAll() // 允许所有请求，绕过权限检查
            .and()
            // 如果您的主配置有OAuth2或其他，这里也需要相应配置，
            // 或者根据需要决定是否完全禁用它们
            // .oauth2ResourceServer().jwt().jwtAuthenticationConverter(jwtAuthenticationConverter)
        return http.build()
    }
}

然后，在您的测试类上引用这个测试配置：

import org.junit.jupiter.api.Test
import org.springframework.beans.factory.annotation.Autowired
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest
import org.springframework.context.annotation.Import
import org.springframework.http.MediaType
import org.springframework.security.test.context.support.WithMockUser
import org.springframework.test.web.servlet.MockMvc
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post
import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status

// 导入测试安全配置
@Import(TestSecurityConfig::class)
@WebMvcTest // 假设您使用WebMvcTest进行控制器测试
class MyControllerTest {

    @Autowired
    private lateinit var mvc: MockMvc

    @Test
    @WithMockUser(roles = ["ADMIN"]) // 即使放宽了权限，保留此注解也是好习惯
    fun `testA`()  {
        mvc
            .perform(
                post("/bla/bla")
                    .contentType(MediaType.APPLICATION_JSON)
            ).andExpect(status().isCreated)
    }
}

通过这种方式，您的测试将使用TestSecurityConfig中定义的更宽松的权限规则，从而避免403错误。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

解决方案二：验证模拟用户角色与安全上下文

如果您不希望在测试中完全放宽安全策略，而是想确保@WithMockUser能够正确地模拟具有特定角色的用户，那么需要仔细排查。

1. 检查角色名称：确保@WithMockUser中指定的角色名称与hasRole()中定义的角色名称完全一致，包括大小写。Spring Security默认会在角色名前添加ROLE_前缀，但hasRole()方法会自动处理这个前缀。例如，hasRole("ADMIN")会匹配ROLE_ADMIN。@WithMockUser(roles = ["ADMIN"])会自动生成ROLE_ADMIN。

2. 调试安全上下文：在控制器方法内部，您可以添加日志或断点来检查当前用户的权限。

   // 在您的控制器方法中
   @PostMapping("/bla/bla")
   fun someEndpoint(): ResponseEntity<String> {
       val authentication = SecurityContextHolder.getContext().authentication
       println("Current User: ${authentication.name}")
       println("Authorities: ${authentication.authorities}")
       // ... 您的业务逻辑
       return ResponseEntity.status(HttpStatus.CREATED).body("Created")
   }

   登录后复制

   运行测试时，观察控制台输出，确认authentication.authorities中是否包含ROLE_ADMIN。如果不存在，则说明@WithMockUser未能成功设置安全上下文，或者被其他配置覆盖。

3. 确保@WithMockUser生效：

   • @WithMockUser需要Spring Security Test模块的支持。确保您的build.gradle或pom.xml中包含spring-security-test依赖。
   • 确保您的测试类被正确地注解，例如@WebMvcTest或@SpringBootTest，以便Spring上下文能够加载。

解决方案三：排查服务层授权

如果前端控制器测试通过，但实际运行时或更深层次的集成测试中仍出现403，那么问题可能出在服务层。

1. 检查@PreAuthorize等注解：在您的服务层方法上，检查是否存在@PreAuthorize("hasRole('ADMIN')")或其他授权注解。

   @Service
   class MyService {
       @PreAuthorize("hasRole('ADMIN')") // 检查这里是否有额外的授权限制
       fun performAdminAction() {
           // ...
       }
   }

   登录后复制

   如果服务层有这样的注解，即使控制器层通过了，服务层也可能再次进行权限检查。

2. 自定义授权逻辑：如果您的应用程序使用了自定义的AccessDecisionManager或PermissionEvaluator，请确保它们在测试环境中也按预期工作，并且能够正确解析模拟用户的权限。

注意事项

• CSRF与404错误：原始问题中提到尝试使用.with(csrf())导致404。由于WebSecurityConfig中csrf().disable()，在测试中添加.with(csrf())是多余的，甚至可能导致问题。404通常表示请求的URL或方法不匹配，与CSRF本身导致的403不同。如果csrf().disable()，则无需在测试中模拟CSRF令牌。
• 测试隔离：在进行测试时，始终推荐使用@TestConfiguration或Spring Profile来为测试环境提供一个独立的、受控的配置，避免测试对主应用程序配置产生副作用。
• OAuth2 Resource Server：如果您的应用程序确实是一个OAuth2资源服务器，jwtAuthenticationConverter的配置在测试中也需要考虑。确保它能正确处理@WithMockUser生成的模拟JWT，或者在测试配置中暂时简化OAuth2相关的配置。

总结

解决Spring Security控制器测试中的403错误，关键在于理解安全配置如何与测试环境中的模拟用户交互。首选的解决方案是为测试环境提供一个临时放宽权限的WebSecurityConfig，以隔离业务逻辑测试与安全配置。如果需要测试实际的权限逻辑，则必须仔细验证@WithMockUser的角色是否正确加载到安全上下文中，并排查可能存在的服务层或其他自定义授权机制。通过系统性的排查和适当的测试配置，可以有效地解决此类权限问题，确保测试的准确性和可靠性。

以上就是Spring Security控制器测试中403错误排查与解决方案的详细内容，更多请关注php中文网其它相关文章！