Spring数据库配置咨询及仅生成表结构无法插入数据排查

问题描述 #

已完成Spring框架与数据库的集成，应用启动正常且生成了表结构，但调用接口插入数据时，数据并未实际写入数据库。相关代码如下：

User实体类 #

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy= GenerationType.AUTO)
    private Integer id;

    private String name;
    private String email;

    // Getters & Setters
    public Integer getId() { return id; }
    public void setId(Integer id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
}

MainController控制器 #

import jakarta.transaction.Transactional;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
public class MainController {
    @Autowired
    private UserRepository userRepository;

    @PostMapping(path="/add")
    public @ResponseBody String addNewUser (@RequestParam String name, @RequestParam String email) {
        User n = new User();
        n.setName(name);
        n.setEmail(email);
        userRepository.save(n);
        return "Saved";
    }

    @GetMapping(path="/all")
    public @ResponseBody Iterable<User> getAllUsers() {
        return userRepository.findAll();
    }
}

UserRepository数据访问接口 #

import org.springframework.data.repository.CrudRepository;

public interface UserRepository extends CrudRepository<User, Integer> {
}

Application启动类 #

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

数据插入失败的原因及修复 #

1. 事务缺失 #

addNewUser方法未添加@Transactional注解，虽然Spring Data JPA的save()默认会触发事务，但在部分场景下（如代理类失效）会导致事务上下文丢失，数据无法提交至数据库。

修复： 在addNewUser方法上添加@Transactional注解：

@PostMapping(path="/add")
@Transactional
public @ResponseBody String addNewUser (@RequestParam String name, @RequestParam String email) {
    // 原有代码不变
}

2. 数据库配置问题 #

检查application.properties（或application.yml）中的核心配置，常见问题点：

• spring.jpa.hibernate.ddl-auto设为create-drop：应用停止后表会被删除，数据无法持久化，建议改为update或none
• 数据库URL参数缺失：MySQL需添加serverTimezone=UTC&useSSL=false避免时区/SSL报错
• 数据库账号权限不足：确保账号拥有INSERT操作权限

3. 主键生成策略适配问题 #

GenerationType.AUTO在不同数据库中行为不一致，MySQL环境下建议显式指定IDENTITY策略，确保主键自增逻辑正常：

@Id
@GeneratedValue(strategy=GenerationType.IDENTITY)
private Integer id;

Spring Boot与数据库的基础配置（以MySQL为例） #

在src/main/resources/application.properties中添加以下配置：

# 数据库连接信息
spring.datasource.url=jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# JPA/Hibernate配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

• spring.jpa.hibernate.ddl-auto参数说明：
  • create：每次启动重建表（清空原有数据）
  • update：根据实体类更新表结构，保留现有数据
  • none：不自动维护表结构（生产环境推荐）
• spring.jpa.show-sql=true：开启SQL日志，便于调试插入语句的执行情况

验证步骤 #

1. 启动应用，调用POST /add接口（传入name和email参数）
2. 查看控制台输出的SQL语句，确认INSERT语句是否正常执行
3. 调用GET /all接口，检查返回结果是否包含新增数据
4. 直接登录数据库，查询user表验证数据是否存在

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