Grails 4.0.10切换用户功能POST /login/impersonate报404求助

核心问题 #

Grails 4.0.10 搭配 spring-security-core:4.0.3 时，主应用中POST请求 /login/impersonate 返回404，但相同配置在Hello World测试应用中可正常运行。

可能的原因及解决方向 #

1. SwitchUserFilter 未正确注册或顺序异常 #

Switch User功能依赖SwitchUserFilter，主应用可能因自定义过滤器或配置覆盖导致该过滤器未加载，或加载顺序错误：

• 验证过滤器是否注册：在BootStrap.groovy中添加代码打印过滤器链：

  def grailsApplication
  def init = { servletContext ->
      def filterChainProxy = grailsApplication.mainContext.getBean('springSecurityFilterChain')
      println "Filter Chain Details: ${filterChainProxy.filterChainMap}"
  }
  

• 检查环境配置文件（如application-prod.groovy），确认grails.plugin.springsecurity.useSwitchUserFilter = true未被覆盖。

2. URL匹配规则优先级冲突 #

主应用的静态规则中存在优先级更高的通配规则，覆盖了/login/impersonate的匹配：

• 注意到你的controllerAnnotations.staticRules中，/*和/*/**这类通配规则放在了/login/impersonate规则之前。Spring Security的URL匹配是先匹配生效，需要将/login/impersonate规则移到最前面：

  grails.plugin.springsecurity.controllerAnnotations.staticRules = [
          [pattern: '/login/impersonate', access: ['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']],
          // 其他规则依次后置
          [pattern: '/homePage/**', access: 'ANY_CHANNEL'],
          [pattern: '/race/search*', access: 'ANY_CHANNEL'],
          // ... 剩余规则
          [pattern: '/*', access: 'ANY_CHANNEL'],
          [pattern: '/*/**', access: 'REQUIRES_SECURE_CHANNEL']
  ]
  

3. 上下文路径或请求路径异常 #

确认表单提交的URL是否正确：

• 在页面中打印${request.contextPath}，验证是否与主应用实际上下文路径/roadrace一致；
• 检查反向代理（如Nginx/Apache）配置，确认请求路径未被修改。

4. 依赖冲突或版本不一致 #

主应用可能存在与spring-security-core冲突的依赖：

• 执行./gradlew dependencies查看依赖树，排查是否有其他依赖引入了不同版本的Spring Security组件；
• 对比测试应用与主应用的build.gradle，确保所有Spring Security相关依赖版本完全一致。

5. 自定义Security配置覆盖默认逻辑 #

如果主应用有自定义WebSecurityConfigurerAdapter实现，可能覆盖了Switch User的默认配置：

• 检查自定义配置类，若存在则手动注册SwitchUserFilter：

  import org.springframework.security.web.authentication.switchuser.SwitchUserFilter
  
  @Override
  protected void configure(HttpSecurity http) throws Exception {
      super.configure(http)
      SwitchUserFilter switchUserFilter = new SwitchUserFilter()
      switchUserFilter.setUserDetailsService(userDetailsService)
      switchUserFilter.setSwitchUserUrl("/login/impersonate")
      switchUserFilter.setExitUserUrl("/logout/impersonate")
      switchUserFilter.setTargetUrlParameter("targetUrl")
      http.addFilterAfter(switchUserFilter, org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter.class)
  }
  

额外排查步骤 #

• 开启Spring Security调试日志，追踪过滤器加载和请求匹配过程：

  // application.groovy中添加
  logging.level.'org.springframework.security' = 'DEBUG'
  

• 对比测试应用与主应用的grails-app/conf/spring/resources.groovy，确认无自定义Bean覆盖Switch User相关配置。

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