DataSource不可为null：ConnectionProvider返回null数据源排查求助

从你给出的错误javax.naming.NameNotFoundException: Name [jdbc/znalezisko] is not bound来看，核心问题是JNDI上下文里找不到你配置的数据源，导致ConnectionProvider无法获取到有效的DataSource实例，最终在UserDAOImpl里返回null。结合你说这个类之前在其他程序正常工作，大概率是当前环境的配置或部署环节出了问题，我给你梳理几个最常见的排查和解决方向：

1. 检查JNDI查找代码是否缺失必要前缀 #

很多开发者容易忽略，在Java EE容器（比如Tomcat）中，JNDI资源通常需要通过java:comp/env/前缀来查找。如果你的ConnectionProvider里是直接用jdbc/znalezisko进行lookup，很可能会找不到资源。

正确的lookup代码应该是这样的：

InitialContext initCtx = new InitialContext();
// 先获取环境上下文
Context envCtx = (Context) initCtx.lookup("java:comp/env");
// 再查找数据源
DataSource dataSource = (DataSource) envCtx.lookup("jdbc/znalezisko");

或者直接合并成一行：

DataSource dataSource = (DataSource) initCtx.lookup("java:comp/env/jdbc/znalezisko");

2. 验证context.xml的数据源配置 #

仔细核对你的context.xml里的数据源配置，确保：

• name属性准确是jdbc/znalezisko（注意大小写，JNDI名称是区分大小写的）
• driverClassName、url、username、password这些参数没有拼写错误，比如MySQL驱动是否是com.mysql.cj.jdbc.Driver（新版本MySQL）而不是旧的com.mysql.jdbc.Driver
• 配置的Resource标签是否放在正确的位置：如果是Tomcat，要么是服务器全局的conf/context.xml，要么是项目的META-INF/context.xml（注意这个文件会在部署时被复制到服务器的部署目录）

举个正确的context.xml数据源配置示例：

<Resource name="jdbc/znalezisko"
          auth="Container"
          type="javax.sql.DataSource"
          driverClassName="com.mysql.cj.jdbc.Driver"
          url="jdbc:mysql://localhost:3306/your_db_name?useSSL=false&serverTimezone=UTC"
          username="db_user"
          password="db_pass"
          maxTotal="20"
          maxIdle="10"
          maxWaitMillis="-1"/>

3. 确认数据库驱动的放置位置 #

JNDI数据源是由服务器容器管理的，所以数据库驱动jar包必须放在服务器的lib目录下（比如Tomcat的CATALINA_HOME/lib），而不是项目的WEB-INF/lib。如果驱动放在项目里，容器的类加载器无法加载到驱动，会导致数据源初始化失败，自然无法绑定到JNDI上下文。

4. 检查web.xml中的资源引用配置 #

确保项目的web.xml里添加了对应的resource-ref配置，用来将项目的JNDI名称和服务器的数据源绑定：

<resource-ref>
    <description>Database Connection for znalezisko</description>
    <res-ref-name>jdbc/znalezisko</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

这个配置是让容器知道项目要引用哪个JNDI资源，缺失的话也可能导致查找失败。

5. 对比新旧环境的差异 #

既然之前在其他程序正常，现在出问题，重点对比两个环境的不同：

• 服务器版本：比如Tomcat 8和Tomcat 10的JNDI配置有没有差异？
• JDK版本：是否用了不同的JDK版本（比如JDK 8 vs JDK 11），导致驱动兼容性问题？
• 部署方式：之前是war包部署，现在是 exploded war？是否部署时context.xml没有被正确复制？
• 服务器配置：是否当前服务器的全局context.xml覆盖了项目的配置？

6. 查看服务器启动日志 #

最后，一定要看服务器的启动日志，比如Tomcat的logs/catalina.out，里面会有数据源初始化的详细日志。如果驱动找不到、数据库连接失败，都会在这里报错，这些错误会导致数据源无法被绑定到JNDI上下文，进而出现你遇到的名称未绑定问题。

按照上面的步骤逐一排查，应该能定位到问题所在。

内容的提问来源于stack exchange，提问作者Krzysztof 303