JpaRepository无法保存Weather对象至数据库，求排查原因

问题描述 #

尝试将Weather对象保存到数据库，但对象未被保存且未抛出任何错误。已尝试更换注解、创建配置、重新连接数据库，均无效果。

相关代码 #

WeatherRepository.java

package com.example.Testww.rep;

import com.example.Testww.Weather;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface WeatherRepository extends JpaRepository<Weather, Long> {
}

Controller.java

package com.example.Testww;

import com.example.Testww.rep.WeatherRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/weather")
public class Controller {

    WeatherService weatherService;

    @Autowired
    public Controller(WeatherService weatherService){
        this.weatherService= weatherService;
    }

    @GetMapping("/save")
    public void SsaveWeather(){
        Weather weather = new Weather();
        weather.setHumidity(5.5);
        weather.setTemperature(15.5);
        weatherService.saveWeather(weather);
    }
}

WeatherService.java

package com.example.Testww;

import com.example.Testww.rep.WeatherRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class WeatherService {

    WeatherRepository weatherRepository;

    @Autowired
    public WeatherService(WeatherRepository weatherRepository){
        this.weatherRepository = weatherRepository;
    }

    public void saveWeather(Weather weather){
        weatherRepository.save(weather);
    }
}

可能的原因及排查步骤 #

1. Weather实体类配置缺失 #

• 确认实体类是否添加了@Entity注解，JPA只会将标注该注解的类识别为持久化实体
• 检查主键字段是否配置了@Id和@GeneratedValue（例如@GeneratedValue(strategy = GenerationType.IDENTITY)），无主键的实体无法被JPA持久化
• 确保实体类的属性有对应的getter/setter方法，或通过Lombok的@Data/@Getter/@Setter注解自动生成，否则JPA无法访问属性值

2. 事务未正确提交 #

• Spring Data JPA的save()方法依赖事务上下文，若调用链中事务未开启或未提交，数据不会写入数据库
• 在WeatherService的saveWeather()方法上添加@Transactional注解，强制开启事务并确保操作提交：

  @Transactional
  public void saveWeather(Weather weather){
      weatherRepository.save(weather);
  }
  

3. 数据库配置异常 #

• 检查application.properties/application.yml中的数据库连接参数（URL、用户名、密码）是否正确，确认连接的是目标数据库
• 确认数据库驱动依赖已正确引入（如MySQL需引入mysql-connector-java）
• 检查spring.jpa.hibernate.ddl-auto配置：若设置为none，需确保数据库中已存在对应的表；若表不存在，可临时设置为create或update让Hibernate自动生成表结构

4. 隐性错误未被日志捕获 #

• 调整日志级别到DEBUG，查看Hibernate的SQL执行细节，可能存在表不存在、字段不匹配等隐性警告：
  在application.properties中添加：

  logging.level.org.hibernate.SQL=DEBUG
  logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
  

  执行保存操作后，查看控制台输出的SQL语句，确认是否有插入操作执行，以及参数是否正确

5. 实体与数据库表不匹配 #

• 检查实体类与数据库表的名称、字段是否一致：可通过@Table(name = "weather")指定实体对应的表名，@Column(name = "humidity")指定字段名
• 确认字段类型匹配：例如实体类中用Double类型，数据库中对应字段需为DOUBLE/FLOAT，避免因类型不兼容导致插入失败

6. Spring组件扫描范围问题 #

• 确认Spring Boot主类的@SpringBootApplication注解是否覆盖了所有组件的包路径，若实体类、Repository等不在默认扫描范围内，需添加：

  @SpringBootApplication
  @EntityScan(basePackages = "com.example.Testww")
  @EnableJpaRepositories(basePackages = "com.example.Testww.rep")
  public class TestwwApplication {
      public static void main(String[] args) {
          SpringApplication.run(TestwwApplication.class, args);
      }
  }
  

内容的提问来源于stack exchange，提问作者Просто Смешно