【Java】已解决：org.springframework.jdbc.datasource.lookup.DataSourceLookupFailureException

屿小夏

发布于 2024-09-16 08:17:04

1220

发布于 2024-09-16 08:17:04

文章被收录于专栏：IT杂谈学习

已解决：org.springframework.jdbc.datasource.lookup.DataSourceLookupFailureException

在使用Spring框架进行开发时，数据源的配置和使用是非常关键的一环。然而，有时候我们可能会遇到org.springframework.jdbc.datasource.lookup.DataSourceLookupFailureException这样的错误。这篇文章将从背景分析、可能出错的原因、错误代码示例、正确代码示例以及注意事项五个方面详细讲解如何解决该问题。

一、分析问题背景

问题背景描述

在开发一个Spring Boot应用时，配置数据源是一个常见的步骤。通常，我们会在应用的配置文件中定义数据源。然而，有时在启动应用或者执行数据库操作时，会遇到类似如下的报错信息：

org.springframework.jdbc.datasource.lookup.DataSourceLookupFailureException: Failed to look up JNDI DataSource with name 'jdbc/myDataSource'; nested exception is javax.naming.NameNotFoundException: Name [jdbc/myDataSource] is not bound in this Context. Unable to find [jdbc].

出现问题的场景

该错误通常发生在以下场景：

应用程序启动时。
尝试从数据源获取连接时。
数据源配置错误或未正确绑定时。

以下是一个简单的代码片段，展示了可能导致该错误的配置方式：

@Configuration
public class DataSourceConfig {
    @Bean
    public DataSource dataSource() {
        JndiDataSourceLookup dataSourceLookup = new JndiDataSourceLookup();
        return dataSourceLookup.getDataSource("jdbc/myDataSource");
    }
}

二、可能出错的原因

分析可能导致该错误的原因，主要有以下几点：

JNDI名称配置错误：数据源名称配置不正确或拼写错误。
数据源未绑定：数据源未在JNDI上下文中正确绑定。
服务器配置问题：应用服务器（如Tomcat）未正确配置JNDI数据源。
Spring配置问题：Spring配置文件中未正确配置JNDI数据源查找方式。

三、错误代码示例

下面是一个可能导致DataSourceLookupFailureException的代码示例：

@Configuration
public class DataSourceConfig {
    @Bean
    public DataSource dataSource() {
        // 错误的JNDI名称
        JndiDataSourceLookup dataSourceLookup = new JndiDataSourceLookup();
        return dataSourceLookup.getDataSource("jdbc/wrongDataSource");
    }
}

在上述代码中，由于jdbc/wrongDataSource不是正确的JNDI名称，导致在查找数据源时抛出DataSourceLookupFailureException。

四、正确代码示例

结合实战场景，以下是一个正确配置数据源的代码示例：

@Configuration
public class DataSourceConfig {
    @Bean
    public DataSource dataSource() {
        JndiDataSourceLookup dataSourceLookup = new JndiDataSourceLookup();
        // 正确的JNDI名称
        return dataSourceLookup.getDataSource("jdbc/myDataSource");
    }
}

此外，还需要确保在应用服务器的配置文件中正确绑定数据源。例如，在Tomcat的context.xml文件中添加如下配置：

<Context>
    <Resource name="jdbc/myDataSource"
              auth="Container"
              type="javax.sql.DataSource"
              maxTotal="20"
              maxIdle="10"
              maxWaitMillis="-1"
              username="dbuser"
              password="dbpassword"
              driverClassName="com.mysql.cj.jdbc.Driver"
              url="jdbc:mysql://localhost:3306/mydb"/>
</Context>