Spring Security下POST请求404/权限不足问题排查求助

1. 路由匹配问题（POST 404） #

• 检查UserController中新增用户的POST接口映射是否正确：
  • 确认@PostMapping注解的路径和前端请求URL完全一致（注意大小写、斜杠前缀）
  • 核对接口参数是否匹配，比如是否需要@RequestBody接收JSON，或是否有@RequestParam参数缺失导致路由无法匹配
• 确认Spring Boot的@ComponentScan覆盖了UserController所在包，避免控制器未被扫描注册

2. Spring Security 权限拦截逻辑 #

• 移除认证配置后出现"无POST权限"，说明默认Security规则拦截了POST请求，需检查SecurityConfig：
  • 确保新增用户的POST接口路径被加入放行规则，示例：

    .authorizeHttpRequests(auth -> auth
        .requestMatchers(HttpMethod.GET, "/**").permitAll()
        .requestMatchers(HttpMethod.POST, "/users/add").permitAll() // 替换为你的实际接口路径
        .anyRequest().authenticated()
    )
    

  • 检查CSRF防护：Spring Security默认开启CSRF，前端POST请求未携带CSRF Token会被拦截，可能表现为403或类似404的异常。若无需CSRF，可临时关闭排查：

    .csrf(csrf -> csrf.disable())
    

3. CustomUserDetails 与认证逻辑 #

• 若新增用户接口需要认证（如仅管理员操作），需确认：
  • CustomUserDetailsService是否正确加载用户权限
  • UserController接口是否添加了对应权限注解（如@PreAuthorize("hasRole('ADMIN')")）
  • SecurityConfig是否开启了方法级权限：

    @EnableMethodSecurity
    

4. User实体与数据库操作 #

• 即使接口能访问，也要排查数据插入逻辑：
  • 确认User实体字段和数据库表完全对应，无未赋值的非空字段
  • 检查Service层是否正确调用save()方法，是否存在事务问题导致数据未提交

内容的提问来源于stack exchange，提问作者Артём Орёл