Wildfly 33配置匹配java:comp/env/jdbc/autoline的数据源遇阻

问题根源 #

java:comp/env/jdbc/autoline 是Web应用的私有组件环境命名空间，Wildfly不允许在全局配置（standalone.xml）中直接定义该名称。你之前尝试的java:jboss/exported/java:comp/env/jdbc/autoline不符合Wildfly的JNDI命名规则，导致应用无法正确解析数据源。

正确解决方案 #

无需修改遗留业务代码，通过「全局数据源配置 + 应用内映射」两步即可解决：

1. 修正standalone.xml中的全局数据源配置

将数据源的JNDI名称改为Wildfly支持的全局命名格式（推荐使用java:jboss/datasources/前缀）：

<datasource jndi-name="java:jboss/datasources/autoline" pool-name="autolinePool" enabled="true">
    <connection-url>jdbc:mysql://192.168.0.10:3306/autoline_dev?useSSL=false</connection-url>
    <driver>mysql</driver>
    <security user-name="xyz" password="abc"/>
</datasource>

2. 在应用内添加映射配置

在应用的WEB-INF目录下添加/修改两个配置文件，将全局数据源映射到应用私有命名空间java:comp/env/jdbc/autoline：

① web.xml（Java EE标准描述符）

定义应用需要的资源引用：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <resource-ref>
        <description>Autoline数据库连接池</description>
        <res-ref-name>jdbc/autoline</res-ref-name>
        <res-type>javax.sql.DataSource</res-type>
        <res-auth>Container</res-auth>
    </resource-ref>
</web-app>

② jboss-web.xml（Wildfly特定描述符）

将全局JNDI名称与应用内的资源引用绑定：

<jboss-web xmlns="http://www.jboss.com/xml/ns/javaee"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-web_10_0.xsd"
           version="10.0">
    <resource-ref>
        <res-ref-name>jdbc/autoline</res-ref-name>
        <jndi-name>java:jboss/datasources/autoline</jndi-name>
    </resource-ref>
</jboss-web>

原理说明 #

• java:comp/env是每个Web应用独立的命名空间，仅在应用内部可见，无法通过全局配置直接创建。
• 通过web.xml声明应用需要的资源，再通过jboss-web.xml将其指向Wildfly全局配置的数据源，即可让遗留代码中的ctx.lookup("java:comp/env/jdbc/autoline")正确找到数据源。

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