【Java】已解决：org.springframework.dao.UncategorizedDataAccessException

屿小夏

发布于 2024-09-11 15:46:36

5500

已解决：org.springframework.dao.UncategorizedDataAccessException

一、分析问题背景

在使用Spring框架进行数据库操作时，开发者有时会遇到org.springframework.dao.UncategorizedDataAccessException报错。这种异常通常发生在数据库访问层，当Spring无法将底层数据库特定的异常分类为已知的Spring DAO异常时，就会抛出这个未分类的数据访问异常。以下是一个可能出现该异常的典型场景：

@Repository
public class UserDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public User getUserById(int id) {
        String sql = "SELECT * FROM users WHERE id = ?";
        return jdbcTemplate.queryForObject(sql, new Object[]{id}, new BeanPropertyRowMapper<>(User.class));
    }
}

当我们运行上述代码并尝试从数据库获取用户信息时，可能会遇到UncategorizedDataAccessException异常。

二、可能出错的原因

导致org.springframework.dao.UncategorizedDataAccessException报错的原因有多种，常见的包括：

数据库连接问题：数据库不可用或连接中断。
SQL语法错误：SQL查询语句存在语法错误。
数据类型不匹配：查询结果的数据类型与映射对象的数据类型不匹配。
驱动程序问题：使用的数据库驱动程序不兼容或版本不正确。
未知异常：其他未知的底层数据库异常。

三、错误代码示例

以下是一个可能导致该报错的代码示例，并解释其错误之处：

@Repository
public class UserDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    // 错误的SQL语法
    public User getUserById(int id) {
        String sql = "SELECT * FORM users WHERE id = ?"; // "FORM" 应为 "FROM"
        return jdbcTemplate.queryForObject(sql, new Object[]{id}, new BeanPropertyRowMapper<>(User.class));
    }
}

错误分析：

SQL语法错误：在SQL查询语句中，“FORM” 应为 “FROM”。这是一个简单的拼写错误，但会导致SQL执行失败，从而引发UncategorizedDataAccessException异常。

四、正确代码示例

为了正确解决该报错问题，我们可以修正SQL语法错误，并确保数据库连接和数据类型匹配。以下是正确的代码示例：

@Repository
public class UserDao {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    // 正确的SQL语法
    public User getUserById(int id) {
        String sql = "SELECT * FROM users WHERE id = ?";
        return jdbcTemplate.queryForObject(sql, new Object[]{id}, new BeanPropertyRowMapper<>(User.class));
    }
}

同时，我们需要确保数据库连接正常，驱动程序正确配置。例如，在Spring配置文件中正确配置数据库连接信息：

<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
    <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
    <property name="username" value="root"/>
    <property name="password" value="password"/>
</bean>