Spring中表单提交未触发@PostMapping接口问题求助

点击提交按钮后页面仅刷新，完全未触发@PostMapping("/register")方法，修改form的action也无效，结合你提供的代码，从以下几个方向排查：

一、CSRF防护拦截（最常见原因） #

Spring Boot默认开启CSRF防护机制，POST请求必须携带CSRF令牌，否则会被静默拦截，表现为页面刷新但请求未到达控制器。

解决方式： #

在表单内添加CSRF隐藏字段（如果使用Thymeleaf模板）：

<form action="/register" class="card-back" method="post">
    <!-- 添加CSRF令牌 -->
    <input type="hidden" th:name="${_csrf.parameterName}" th:value="${_csrf.token}"/>
    <!-- 原有表单内容 -->
    <div class="center-wrap">
        <!-- ... 其余代码不变 ... -->
    </div>
</form>

如果是纯HTML页面，可通过控制器将CSRF参数传入Model，再渲染到页面；测试阶段也可临时关闭CSRF（仅用于排查，生产环境禁止）：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable();
    }
}

二、实体类参数绑定失败 #

你的Users实体包含name、phone_number等字段，若数据库或JPA层面设置了非空约束，但表单仅提交了email和password，Spring MVC在绑定参数到Users对象时会失败，导致请求无法进入控制器方法。

解决方式： #

1. 给Users类中未在表单提供的字段设置允许为空，或添加默认值：

@Column(name = "name")
private String name; // 若数据库允许为空，无需额外注解；否则添加@Column(nullable = true)

2. 在控制器方法中添加参数校验，捕获绑定错误：

@PostMapping("/register")
public String PostUser (@Valid Users users, BindingResult result, Model model)
{
    if(result.hasErrors()){
        // 打印错误信息，排查具体绑定失败的字段
        result.getAllErrors().forEach(error -> System.out.println(error.getDefaultMessage()));
        return "reg";
    }
    System.out.println("зашел");
    usersService.createUser(users);
    return "redirect:/";
}

三、请求路径不匹配 #

检查项目是否配置了上下文路径（application.properties中server.servlet.context-path），如果有，表单的action需要加上上下文路径前缀，比如上下文路径是/demo，则action应为/demo/register。

同时打开浏览器开发者工具的网络标签，查看提交请求的状态码：

• 404：说明请求路径错误，控制器未匹配到该路径
• 403：大概率是CSRF拦截导致

四、自定义过滤器/拦截器拦截请求 #

排查项目中是否存在自定义的过滤器或拦截器，是否对POST请求做了拦截处理，可临时禁用自定义过滤器测试请求是否能到达控制器。

你提供的参考代码： #

表单HTML代码：

<form action="/register"  class="card-back" method="post">
        <div class="center-wrap">
            <div class="section text-center">
                <h4 class="mb-4 pb-3">РЕГИСТРАЦИЯ</h4>
                    <div class="form-group mt-2">
                        <input type="email" name="email" class="form-style" placeholder="Почта" id="logemail" autocomplete="off">
                        <i class="input-icon  bi bi-at"></i>
                    </div>  
                    <div class="form-group mt-2">
                        <input type="password" name="password" class="form-style" placeholder="Пароль" id="logpass" autocomplete="off">
                        <i class="input-icon bi bi-lock"></i>
                    </div>
                            
                <button  class="btn mt-4" type="submit">submit</button>
             </div>
       </div>
</form>

Controller代码：

@Controller
@RequiredArgsConstructor
public class RegController {
    private final UsersService usersService;
    @Autowired
    private UsersRepo usersRepo;
    @GetMapping("/register")
    public String reg( Model model) {
        System.out.println("регистрация");
        return "reg";
    }

    @PostMapping("/register")
   public String PostUser (Users users,Model model)
    {
        System.out.println("зашел");
        usersService.createUser(users);
        return "redirect:/";
    }
}

User Model代码：

@Entity
@Getter
@Setter
@Data
@Table(name = "users")
public class Users implements UserDetails {

    @Id
    @Column(name = "email")
    private String email;
    @Column (name = "password",length = 1000)
    private String password;
    @Column (name = "name")
    private String name;
    @Column(name="phone_number",unique = true)
    private String phone_number;
    @Column(name = "bDay")
    private java.sql.Date bDay;
    @Column(name = "active")
    private boolean active;
    
    private char sex;
    @ElementCollection(targetClass = Role.class,fetch = FetchType.EAGER)
    @CollectionTable (name = "user_role",
            joinColumns = @JoinColumn(name = "user_id"))
    @Enumerated(EnumType.STRING)
    private Set<Role> roles=new HashSet<>();
    public Users()
    {}
    public Users( String email, String password) {
        this.email = email;
        this.password = password;
    }
}

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