【java报错已解决】org.springframework.dao.NonTransientDataAccessException

鸽芷咕

发布于 2025-05-29 14:57:39

2620

引言：

在Java开发领域，尤其是在使用Spring框架进行数据访问操作时，遇到报错那可真是让人头疼不已。其中，org.springframework.dao.NonTransientDataAccessException这个报错常常会让开发者和环境配置者们陷入困惑。它就像是一个隐藏在代码深处的小怪兽，时不时地冒出来捣乱，阻碍项目的顺利进行。那么，当面对这个恼人的报错时，我们该如何精准地找出问题所在，并迅速将其解决呢？今天，就让我们一起深入剖析这个报错，探寻有效的解决之道。

一、问题描述：

1.1报错示例：

假设我们正在开发一个简单的Java应用程序，使用Spring框架来管理数据库访问。以下是一个模拟的场景示例，展示了可能导致org.springframework.dao.NonTransientDataAccessException报错的代码情况。

首先，我们有一个简单的实体类 User，用于表示用户信息：

public class User {
    private Long id;
    private String username;
    private String password;

    // 构造函数
    public User(Long id, String username, String password) {
        this.id = id;
        this.username = username;
        this.password = password;
    }

    // Getter和Setter方法
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

然后，我们创建一个 UserDao 接口，用于定义对用户数据进行操作的方法：

import java.util.List;

public interface UserDao {
    User findById(Long id);
    List<User> findAll();
    void save(User user);
    void update(User user);
    void deleteById(Long id);
}

接下来，我们实现这个 UserDao 接口，这里假设我们使用JDBC来进行数据库访问（实际应用中可能会使用更高级的持久化框架，如MyBatis、Hibernate等，但原理类似）：

import org.springframework.dao.DataAccessException;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public class UserDaoImpl implements UserDao {

    private final JdbcTemplate jdbcTemplate;

    public UserDaoImpl(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    @Override
    public User findById(Long id) {
        try {
            String sql = "SELECT * FROM users WHERE id =?";
            return jdbcTemplate.queryForObject(sql, new Object[]{id}, (rs, rowNum) -> {
                return new User(rs.getLong("id"), rs.getString("username"), rs.getString("password"));
            });
        } catch (DataAccessException e) {
            throw new org.springframework.dao.NonTransientDataAccessException("查询用户失败", e);
        }
    }

    @Override
    public List<User> findAll() {
        try {
            String sql = "SELECT * FROM users";
            return jdbcTemplate.query(sql, (rs, rowNum) -> {
                return new User(rs.getLong("id"), rs.getString("username"), rs.getString("password"));
            });
        } catch (DataAccessException e) {
            throw new org.springframework.dao.NonTransientDataAccessException("查询所有用户失败", e);
        }
    }

    @Override
    public void save(User user) {
        try {
            String sql = "INSERT INTO users (username, password) VALUES (?,?)";
            jdbcTemplate.update(sql, user.getUsername(), user.getPassword());
        } catch (DataAccessException e) {
            throw new org.springframework.dao.NonTransientDataAccessException("保存用户失败", e);
        }
    }

    @Override
    public void update(User user) {
        try {
            String sql = "UPDATE users SET username =?, password =? WHERE id =?";
            jdbcTemplate.update(sql, user.getUsername(), user.getPassword(), user.getId());
        } catch (DataAccessException e) {
            throw new org.springframework.dao.NonTransientDataAccessException("更新用户失败", e);
        }
    }

    @Override
    public void deleteById(Long id) {
        try {
            String sql = "DELETE FROM users WHERE id =?";
            jdbcTemplate.update(sql, id);
        } catch (DataAccessException e) {
            throw new org.springframework.dao.NonTransientDataAccessException("删除用户失败", e);
        }
    }
}

在上述代码中，我们在每个数据访问方法（如 findById、findAll、save、update、deleteById）中，如果出现 DataAccessException 异常，就会将其包装成org.springframework.dao.NonTransientDataAccessException并抛出，同时附带相应的提示信息（如“查询用户失败”、“查询所有用户失败”等）。

假设我们在主程序中尝试调用这些方法，例如：

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class MainApp {
    public static void main(String[] args) {
        ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
        UserDao userDao = context.getBean(UserDao.class);

        // 尝试查询一个不存在的用户
        User user = userDao.findById(9999L);

        // 或者尝试保存一个不符合数据库约束的用户
        User newUser = new User(null, "invalid_username", "invalid_password");
        userDao.save(newUser);
    }
}

在上述 MainApp 类的 main 方法中，我们首先通过Spring容器获取 UserDao 实例，然后分别进行了两种可能导致报错的操作：一是查询一个很可能不存在的用户（通过 findById 方法传入一个较大的、不太可能存在的用户ID）；二是尝试保存一个不符合数据库约束的用户（这里创建了一个 User 实例，其 id 为 null，并且用户名和密码可能不符合数据库表的约束条件）。

1.2报错分析：

当运行上述代码并进行上述操作时，就很可能会触发org.springframework.dao.NonTransientDataAccessException这个报错。

原因在于，在 UserDaoImpl 类的各个数据访问方法中，我们对可能出现的 DataAccessException 异常进行了重新包装并抛出为org.springframework.dao.NonTransientDataAccessException。而这些 DataAccessException 异常本身可能是由于多种原因引起的，比如：

在 findById 方法中，当查询一个不存在的用户时，JDBC执行查询语句返回的结果集为空，这会导致 jdbcTemplate.queryForObject 方法抛出 DataAccessException，进而被包装成org.springframework.dao.NonTransientDataAccessException抛出。
在 save 方法中，当尝试保存一个不符合数据库约束的用户（如 id 为 null，或者用户名、密码不符合表的约束条件），JDBC执行插入语句会失败，导致 jdbcTemplate.update 方法抛出 DataAccessException，同样会被包装成org.springframework.dao.NonTransientDataAccessException抛出。

简单来说，就是在进行数据访问操作时，由于数据本身的问题（如不存在对应的数据、不符合数据库约束等）或者数据库操作执行的问题（如SQL语句错误、数据库连接故障等），导致了底层的 DataAccessException 异常产生，然后我们又将其包装成了org.springframework.dao.NonTransientDataAccessException，所以这个异常就被抛出了。

1.3解决思路：

要解决这个问题，我们需要从以下几个方面入手：

首先，要明确具体是哪个数据访问操作导致了报错，是查询、保存、更新还是删除操作。通过仔细查看报错信息中的提示内容（如“查询用户失败”、“保存用户失败”等），可以初步确定问题所在的操作。
然后，针对具体的操作，检查相关的数据条件是否满足要求。比如在查询操作中，要确保查询条件是合理的（如查询的用户ID是否确实存在）；在保存操作中，要确保要保存的数据符合数据库的约束条件（如 id 是否为必填项、用户名和密码是否符合格式要求等）。
再者，检查数据库相关的配置是否正确，包括数据库连接信息（如主机名、端口号、用户名、密码等）、数据库的模式（如数据库表结构是否正确、是否存在需要的索引等）以及数据库的状态（如是否正在维护、是否存在性能问题等）。
最后，对于一些可能由于SQL语句错误导致的问题，可以通过查看详细的日志信息（如果有的话）或者在数据库管理工具中直接执行相关的SQL语句来验证其正确性。

二、解决方法：

2.1方法一：检查数据条件

针对不同的数据访问操作，我们需要仔细检查相关的数据条件是否满足要求。

查询操作：

在 findById 类型的查询操作中，要确保查询条件（如用户ID）是合理的，即确实存在对应的用户。我们可以通过在数据库管理工具中先手动查询一下，看看是否能找到对应的用户。如果是通过其他条件进行查询，也要确保这些条件是准确的，不会导致查询结果为空。

例如，在上述 UserDaoImpl 类的 findById 方法中，如果经常出现查询不存在的用户导致报错的情况，我们可以在调用 findById 方法之前，先在数据库中进行验证：

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class MainApp {
    public static void main(String[] args) {
        ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
        UserDao userDao = context.getBean(UserDao.class);

        Long idToFind = 9999L;
        // 先在数据库中验证用户是否存在
        boolean userExists = checkUserExists(idToFind);
        if (userExists) {
            User user = userDao.findById(idToFind);
        } else {
            System.out.println("该用户不存在，无需进行查询操作");
        }

        // 或者尝试保存一个不符合数据库约束的用户
        User newUser = new User(null, "invalid_username", "invalid_password");
        userDao.save(newUser);
    }

    private static boolean checkUserExists(Long id) {
        // 这里可以通过JDBC或者其他数据库访问方式，在数据库中查询是否存在指定ID的用户
        return false;
    }
}

保存操作：

在 save 类型的保存操作中，要确保要保存的数据符合数据库的约束条件。比如，检查 id 是否为必填项，如果是，要确保提供了有效的 id 值；检查用户名和密码是否符合格式要求，如长度限制、字符类型限制等。

例如，在上述 UserDaoImpl 类的 save 操作中，如果经常出现保存不符合约束条件的用户导致报错的情况，我们可以在调用 save 方法之前，先对要保存的用户数据进行验证：

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class MainApp {
        public static void main(String[] args) {
            ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
            UserDao userDao = context.getBean(UserDao.class);

            // 尝试查询一个不存在的用户
            User user = userDao.findById(9999L);

            User newUser = new User(null, "invalid_username", "invalid_password");
            // 先验证要保存的用户数据是否符合约束条件
            boolean isValidUser = validateUser(newUser);
            if (isValidUser) {
                userDao.save(newUser);
            } else {
                System.out.println("该用户数据不符合约束条件，无法保存");
            }
        }

        private static boolean validateUser(User user) {
            // 这里可以根据数据库的约束条件，对用户的各项数据进行验证
            return false;
        }
}

2.2方法二：检查数据库配置

我们需要仔细检查数据库相关的配置是否正确。

数据库连接信息：

确保数据库连接信息（如主机名、端口号、用户名、密码等）是正确的。可以通过在配置文件（如 applicationContext.xml）中仔细核对相关的配置项，或者在代码中直接查看设置的连接参数。

例如，在上述 UserDaoImpl 类中，JdbcTemplate 的构造函数接受数据库连接参数，如果这些参数有误，可能会导致数据库连接失败，进而引发一系列的数据访问异常。我们可以在 MainApp 类的 main 方法中添加以下代码来验证连接参数：

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import org.springframework.jdbc.core.JdbcTemplate;

public class MainApp {
    public static void main(String[] args) {
        ApplicationContext context = new ClassPathXmlApplicationContext("applicationContext.xml");
        UserDao userDao = context.getBean(UserDao.class);

        // 验证数据库连接参数
        JdbcTemplate jdbcTemplate = context.getBean(JdbcTemplate.class);
        try {
            jdbcTemplate.getDataSource().getConnection();
            System.out.println("数据库连接参数正确");
        } catch (Exception e) {
            System.out.println("数据库连接参数有误，请检查");
            e.printStackTrace();
        }

        // 尝试查询一个不存在的用户
        User user = userDao.findById(9999L);

        // 或者尝试保存一个不符合数据库约束的用户
        User newUser = new User(null, "invalids_username", "invalid_password");
        userDao.save(newUser);
    }
}

数据库的模式：

检查数据库的模式是否正确，包括数据库表结构是否正确、是否存在需要的索引等。可以通过在数据库管理工具中查看表结构、索引信息等，确保与代码中预期的数据库模式一致。

例如，在上述 User 实体类和 UserDao 接口以及实现类的代码中，假设我们预期数据库中有一个 users 表，其结构应该与 User 实体类的属性相对应。如果表结构有误，比如少了某个字段或者字段类型不对，可能会导致数据访问操作失败。我们可以在数据库管理工具中打开对应的数据库，查看 users 表的结构是否正确。

数据库的状态：

检查数据库的状态是否良好，包括是否正在维护、是否存在性能问题等。如果数据库正在维护，可能会导致部分数据访问操作无法正常进行；如果存在性能问题，可能会导致数据访问操作超时等异常。可以通过查看数据库管理系统的监控信息或者咨询数据库管理员来了解数据库的状态。

2.3方法三：检查SQL语句

对于一些可能由于SQL语句错误导致的问题，我们可以通过以下方式进行检查。

在数据库管理工具中执行：

可以将代码中相关的SQL语句（如 UserDaoImpl 类中各个数据访问方法中的SQL语句）复制到数据库管理工具（如MySQL Workbench、Oracle SQL Developer等）中，直接执行这些语句，看是否能正确执行。如果在数据库管理工具中执行失败，那么很可能就是SQL语句本身存在问题，需要进行修改。

例如，在 UserDaoImpl 类的 findById 方法中，SQL语句是 “SELECT * FROM users WHERE id =?”，我们可以将其复制到数据库管理工具中，替换问号处为一个具体的用户ID（如 1），然后执行看是否能正确返回结果。

查看详细日志信息：

如果项目中设置了详细的日志记录功能，那么可以通过查看日志信息来了解SQL语句的执行情况。在Spring框架中，我们可以通过配置日志级别等方式来获取更详细的日志信息。

例如，在 applicationContext.xml 规定了日志记录的相关配置，当出现org.springframework.dao.NonTransientDataAccessException报错时，我们可以通过查看日志来了解在哪个数据访问方法中出现了问题，以及具体的SQL语句执行情况，如是否抛出了异常、执行时间等。

2.4方法四：使用异常处理机制

Spring框架提供了丰富的异常处理机制，我们可以利用这些机制来更好地处理org.springframework.dao.NonTransientDataAccessException这个异常。

全局异常处理：

我们可以创建一个全局异常处理类，用于处理所有类型的异常，包括org.springframework.dao.NonTransientDataAccessException。

例如，创建一个 GlobalExceptionHandler 类：

import org.springframework.dao.NonTransientDataAccessException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NonTransientDataAccessException.class)
    public String handleNonTransientDataAccessException(NonTransientDataAccessException e) {
        // 在这里可以根据具体的报错情况，给出更详细的处理建议
        return "数据访问出现问题：" + e.getMessage();
    }
}

在上述代码中，通过 @ExceptionHandler 注解，我们指定了这个方法用于处理org.springframework.dao.NonTransientDataAccessException这个异常。当出现这个异常时，会返回一个包含报错信息的字符串，我们可以根据实际情况对这个处理方法进行进一步的优化，比如根据不同的报错原因给出不同的处理建议。