WebSphere Liberty数据源JNDI查找报CWNEN0030E错误如何解决？

1. 补充缺失的Liberty功能组件 #

你当前的featureManager配置中缺少JDBC和JNDI相关的必备功能，这是最可能的报错原因。请修改server.xml的功能列表，添加以下配置：

<featureManager>
    <!-- 保留原有feature -->
    <feature>appSecurity-2.0</feature>
    <feature>jaxrs-2.0</feature>
    <feature>jsp-2.3</feature>
    <feature>localConnector-1.0</feature>
    <feature>jaxws-2.2</feature>
    <feature>ldapRegistry-3.0</feature>
    <!-- 新增必备功能 -->
    <feature>jdbc-4.2</feature>
    <feature>jndi-1.0</feature>
</featureManager>

你可以根据你的应用JDK版本调整JDBC功能版本，比如JDK8以上可用jdbc-4.3。

2. 修正数据源配置错误 #

你当前的jdbcDriver属性配置错误：com.ibm.db2.jcc.DB2Driver是JDBC驱动类，不是javax.sql.DataSource接口的实现类，同时你缺失了驱动库的定义。修正后的完整数据源配置参考如下：

<!-- 先定义DB2驱动库，路径替换为你实际存放db2jcc4.jar的路径 -->
<library id="DB2JCCLib">
    <fileset dir="/path/to/your/db2/driver" includes="db2jcc4-4.22.29.jar db2jcc_license_cu.jar"/>
</library>

<dataSource jndiName="jdbc/db2a" type="javax.sql.DataSource">       
    <jdbcDriver 
        javax.sql.DataSource="com.ibm.db2.jcc.DB2DataSource" 
        libraryRef="DB2JCCLib"
    />
    <properties.db2.jcc  
        driverType="4" 
        databaseName="DB1" 
        serverName="host.name" 
        portNumber="446"
        user="你的数据库用户名"
        password="你的数据库密码"
    />             
</dataSource>

注意如果需要数据库认证，必须补充user和password属性，否则数据源初始化会失败。

3. 检查应用的resource-ref声明 #

ibm-web-bnd.xml的作用是把应用内的资源引用绑定到服务器的JNDI资源，前提是你的应用WEB-INF/web.xml中必须有对应的资源声明，示例如下：

<resource-ref>
    <description>DB2 Datasource</description>
    <res-ref-name>jdbc/db2a</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

如果用注解方式声明资源引用，要确保@Resource(name = "jdbc/db2a")的名称和绑定配置完全一致。

4. 验证JNDI查找逻辑 #

确认代码中string5变量的值是完全匹配的jdbc/db2a，大小写、符号都不能有差异。如果上述配置都修正后仍报错，可以先直接查找全局JNDI名称测试数据源是否正常注册：

InitialContext initialContext = new InitialContext();
DataSource dataSource = (DataSource)initialContext.lookup("jdbc/db2a");

如果直接查找全局JNDI正常，说明应用级的资源绑定配置有误，可以检查ibm-web-bnd.xml是否放在WEB-INF目录下，格式是否符合规范。

5. 开启调试日志定位问题 #

如果仍无法解决，在server.xml中添加日志配置，输出JDBC和注入模块的详细日志，排查数据源初始化阶段的报错：

<logging 
    traceSpecification="com.ibm.ws.jdbc.*=all:com.ibm.ws.injection.*=all"
    traceFileName="trace.log"
    maxFileSize="100MB"
    maxFiles="10"
/>

启动服务后查看trace.log，搜索是否有驱动加载失败、数据源认证失败、JNDI注册失败之类的错误信息，针对性解决即可。

内容的提问来源于stack exchange，提问作者Berlin Brown