JpaRepository.save(entity)失效，SQLError 0、SQLState: null问题求助

一、JpaRepository.save() 报错排查步骤 #

• 核对数据库连接配置：检查application.properties/yml中的数据库URL、用户名、密码、驱动类是否正确。比如MySQL需确保URL包含serverTimezone、useSSL等必要参数，库名拼写无误。
• 校验实体类映射：
  • 实体类必须标注@Entity，表名不匹配时需用@Table(name="你的表名")指定；
  • 主键字段必须加@Id，并配置与数据库匹配的生成策略（比如MySQL自增主键用@GeneratedValue(strategy = GenerationType.IDENTITY)）；
  • 确认字段名与数据库列名匹配，可开启驼峰转下划线配置：spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy；
  • 检查Lombok注解（如@Data）是否生效，可查看编译后的class文件确认getter/setter是否生成。
• 检查事务配置：Service层执行save的方法需标注@Transactional注解，无事务环境下JPA操作可能抛出异常。
• 开启SQL日志排查：添加以下配置打印执行的SQL语句，直接在数据库客户端执行排查具体错误：

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

• 验证数据库权限：确认应用使用的数据库账号拥有目标表的INSERT权限。
• 检查实体字段约束：排查是否存在非空字段传null、字段长度超过数据库列限制、日期格式不匹配等违反数据库约束的情况。

二、新手学习资源推荐 #

• Spring Boot入门：跟着官方入门教程实现Todo应用，掌握核心注解、配置方式、CRUD接口开发流程。
• JPA/Hibernate学习：先吃透JPA规范基础，再学习Hibernate官方文档，重点掌握实体映射、主键策略、查询方法、事务管理这几块核心内容。
• Lombok快速上手：通过官方文档熟悉常用注解（@Data、@NoArgsConstructor、@Builder等）的用法，理解其编译期生成代码的原理。
• 数据库基础补全：学习SQL基础语法、数据库约束（主键/外键/非空/唯一）、事务ACID特性，这是排查JPA问题的底层基础。
• 实战项目练习：从简单的用户管理、博客系统入手，用Spring Boot+JPA+MySQL实现完整功能，在实战中积累问题排查经验。

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