Java Play 2.8.x中jdbc与javaJdbc库依赖的区别

官方Java JDBC配置文档给出的标准依赖声明如下：

libraryDependencies ++= Seq(
  javaJdbc
)

实际开发中不少开发者发现仅声明jdbc依赖也能正常运行：

libraryDependencies ++= Seq(
  jdbc
)

二者并不是等价依赖，具体差异和适用场景如下：

核心定位差异 #

• jdbc是Play框架JDBC能力的底层核心模块，原生面向Scala语言生态设计，独立实现了连接池管理、JDBC基础操作封装、事务控制等所有核心能力，本身不包含任何Java生态适配逻辑。
• javaJdbc是专门面向Java开发者提供的上层适配模块，本身没有重复实现JDBC核心逻辑，而是通过依赖传递引入jdbc模块，在其基础上额外封装了三类Java专属能力：符合Java编码习惯的Database操作API、和Play默认Guice容器的Java风格注入绑定、Scala运行时异常到Java标准异常体系的转换逻辑。简单来说，javaJdbc是jdbc的Java生态超集封装。

单独引入jdbc可运行的原因 #

Java项目仅引入jdbc能跑通，本质是两个原因：

• JDBC的核心能力（连接创建、SQL执行、事务管理）本身就是jdbc模块提供的，只要直接调用底层接口，基础功能完全可以正常使用
• 简单业务场景下，开发者通常不会用到javaJdbc提供的专属适配能力：比如不通过Guice注入Java风格的数据源实例、手动捕获所有数据库操作异常、没有用到Java侧的专属配置绑定逻辑，自然感知不到差异。

但这种写法属于非标准用法，一旦项目需要集成Java生态ORM框架（如Hibernate、MyBatis）、做精细化异常捕获、升级Play版本时，很容易出现依赖注入失败、异常类型不匹配、配置不生效的隐性问题。

适用场景 #

• Scala技术栈开发Play项目：仅引入jdbc依赖即可，额外引入javaJdbc会增加无用的冗余依赖，没有实际价值。
• Java技术栈开发Play项目：必须按照官方示例引入javaJdbc依赖，所有官方的JDBC配置规则、Java生态组件集成方案都是基于javaJdbc做的测试验证，使用该依赖才能保证框架行为符合预期，避免后续出现兼容性问题。

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