Spring Boot+Thymeleaf模态框表单数据无法保存至数据库问题

安全阿岳

2026-6-23

问题描述

基于Spring Boot + Thymeleaf开发的预约系统中，用户通过模态表单提交的预约数据已成功绑定到AppointmentForm并传递至Controller，但数据无法写入数据库。仅能看到Service中In saveAppointment的日志输出，后续流程无日志记录，数据未持久化。

排查步骤与解决方案

1. 确认用户ID的有效性与传递逻辑

前端验证：在浏览器开发者工具中查看表单提交参数，确认userId是否为有效数值（非null或不存在的ID）。若userId为空，说明Thymeleaf的th:value="${userId}"未正确获取当前登录用户ID，建议改为从SecurityContextHolder直接获取认证用户，避免依赖页面传递：
```
// 在Controller中获取当前登录用户ID
Authentication auth = SecurityContextHolder.getContext().getAuthentication();
Long userId = ((User) auth.getPrincipal()).getId();
appointmentForm.setUserId(userId);
```

后端校验：在Service中对userId做非空判断，避免触发空指针异常：

if (appointmentForm.getUserId() == null) {
    throw new IllegalArgumentException("User ID cannot be null");
}

2. 修复异常捕获与日志输出

当前代码中，用户查询环节的异常会直接中断流程且无详细日志，导致无法定位问题。修改Service代码，补充异常日志并重新抛出异常：

// Fetch user by userId from appointmentForm
User user;
try {
    user = userRepository.findById(appointmentForm.getUserId())
            .orElseThrow(() -> new RuntimeException("User not found with ID: " + appointmentForm.getUserId()));
} catch (RuntimeException e) {
    System.err.println("Failed to fetch user: " + e.getMessage());
    e.printStackTrace();
    throw e; // 重新抛出异常，让Controller统一处理
}

同时确认userProfile页面是否正确渲染errorMessage属性，以便直观展示错误信息。

3. 修正事务与异常回滚逻辑

Service方法添加了@Transactional，但内部对save操作的try-catch会导致Spring无法触发事务回滚（仅未捕获的RuntimeException才会触发回滚）。移除save块的try-catch，让异常向上抛出：

// 移除原有的try-catch，改为直接调用save
appointmentRepository.save(appointment);
System.out.println("Appointment saved");

4. 完善实体映射与初始化

初始化serviceTypes集合：当前实体中serviceTypes未初始化，可能导致Hibernate抛出空指针异常，补充初始化代码：

@ElementCollection(targetClass = ServiceType.class)
@CollectionTable(name = "appointment_services", joinColumns = @JoinColumn(name = "appointment_id"))
@Enumerated(EnumType.STRING)
@Column(name = "service_type")
private Set<ServiceType> serviceTypes = new HashSet<>();

校验枚举值匹配：确认ServiceType枚举的取值与表单提交的serviceTypes值完全一致（大小写、拼写），避免Enum.valueOf()抛出IllegalArgumentException。

5. 启用SQL日志定位数据库问题

在application.properties中添加配置，查看实际执行的SQL语句，排查数据库层面的约束或映射问题：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
logging.level.org.hibernate.type.descriptor.sql=trace

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