Payara6部署WAR包报错：javax.sql.DataSource并非允许的属性值类型

• 检查应用内数据源配置的类型匹配
  确认WAR包中的配置文件（如persistence.xml、web.xml或框架配置文件）没有将javax.sql.DataSource类型直接赋值给仅支持字符串（如JNDI名称）的属性。例如：

  • persistence.xml中<jta-data-source>必须是JNDI名称字符串（如jdbc/MyDB），而非javax.sql.DataSource类实例。
  • web.xml的<resource-ref>中<res-type>需改为jakarta.sql.DataSource（Payara 6基于Jakarta EE 9+，不再支持旧的javax命名空间类型）。

• 排查依赖冲突问题
  检查WAR包的WEB-INF/lib目录，确认是否打包了重复的JDBC相关依赖（如mysql-connector-java.jar）。Payara已全局部署MySQL Connector/J 9.1.0，WAR内重复打包会导致类加载器冲突——不同类加载器加载的DataSource类属于不同类型，触发类型转换异常。若存在重复依赖，直接删除。

• 验证Payara连接池的数据源类配置
  确认JDBC连接池的数据源类使用Jakarta EE兼容的版本：

  • 正确类名应为com.mysql.cj.jakarta.MysqlDataSource（适配Jakarta EE），而非旧版的com.mysql.cj.jdbc.MysqlDataSource（仅支持Java EE）。
    进入Payara管理控制台，查看连接池的"Datasource Classname"字段是否配置正确。

• 检查应用代码的注入类型
  确认代码中数据源注入使用的是Jakarta EE的类型：

  • 将代码中import javax.sql.DataSource替换为import jakarta.sql.DataSource。
  • 例如@Resource注入时，类型应为jakarta.sql.DataSource：

    @Resource(name = "jdbc/MyDB")
    private jakarta.sql.DataSource dataSource;
    

• 测试最小化WAR包
  构建一个仅包含必要代码的最小WAR包（仅含简单的数据源注入逻辑），排除框架或其他复杂配置的干扰，验证是否仍出现错误。若最小化包部署正常，再逐步添加原应用的组件，定位冲突点。

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