jpa-vs-mybatis-analysis

约 1652 字大约 6 分钟

2026-02-08

先说结论

如果你时间有限，只看这一段：

复杂 SQL 多、报表多、数据库方言特性重（如 PostgreSQL jsonb）：优先 MyBatis（或 MyBatis-Plus）。
标准 CRUD 多、领域关系清晰、希望快速开发：优先 JPA（Spring Data JPA）。
大多数中大型项目最终是混用：核心复杂查询用 MyBatis，简单聚合读写用 JPA。

这不是“谁更先进”的问题，而是“谁更匹配你的业务形态”。

1. 两者本质差异：ORM vs SQL Mapper

JPA（ORM）：你主要操作“对象”，框架帮你生成和管理 SQL。
MyBatis（SQL Mapper）：你主要操作“SQL”，框架帮你做参数绑定和结果映射。

flowchart LR
  A["业务代码"] --> B["JPA Repository"]
  B --> C["JPQL/派生方法"]
  C --> D["ORM 引擎生成 SQL"]
  D --> E["数据库"]

  A2["业务代码"] --> B2["MyBatis Mapper"]
  B2 --> C2["手写 SQL/XML"]
  C2 --> E2["数据库"]

一句话理解：

JPA 追求“面向对象开发效率”。
MyBatis 追求“面向 SQL 的可控性”。

2. 9 个维度对比（教学版）

维度	JPA	MyBatis / MyBatis-Plus	选型建议
学习曲线	要理解实体状态、懒加载、脏检查	要理解 SQL/索引/执行计划	初学 CRUD 选 JPA；要深控性能选 MyBatis
CRUD 开发效率	非常高（`JpaRepository`）	中等（MP 可提高）	标准增删改查：JPA 更快
复杂查询表达	复杂时常回退 `nativeQuery`	天然强项，SQL 直写	报表/统计/复杂 join：MyBatis
动态条件查询	Specification/Criteria 类型安全	XML `if/where/trim` 直观	团队习惯决定，MyBatis 更“所见即所得”
数据库方言能力	依赖 ORM 支持，方言越重越麻烦	方言可直接用	`jsonb`/窗口函数/CTE：MyBatis
性能可观测性	需额外关注隐式 SQL、N+1	SQL 显式可见	强调可观测与调优：MyBatis
事务模型	与 Spring `@Transactional` 深度融合	同样可用 Spring 事务	两者都行，关键是边界规范
架构耦合	容易把 Entity 暴露到业务层	天然偏“防腐层”思想	DDD 场景更容易守住边界
团队维护成本	快，但要有 ORM 经验防坑	稳，但 SQL 规范必须统一	按团队基因选择，不要盲目“统一”

3. 四组代码示例（最关键）

下面示例是教学代码，重点看“表达方式差异”。

3.1 场景 A：动态条件查询

MyBatis（XML 动态 SQL）

<select id="findByCondition" resultType="WarningStrategyDO">
  SELECT * FROM gsmm_warning_strategy
  <where>
    <if test="treeId != null and treeId != ''">
      AND tree_id = #{treeId}
    </if>
    <if test="eventType != null and eventType != ''">
      AND event_type = #{eventType}
    </if>
    AND is_deleted = false
  </where>
</select>

JPA（Specification）

public interface WarningStrategyRepository extends JpaRepository<WarningStrategyEntity, String>,
        JpaSpecificationExecutor<WarningStrategyEntity> {
}

public static Specification<WarningStrategyEntity> byCondition(String treeId, String eventType) {
    return (root, query, cb) -> {
        List<Predicate> predicates = new ArrayList<>();
        if (treeId != null && !treeId.isBlank()) {
            predicates.add(cb.equal(root.get("treeId"), treeId));
        }
        if (eventType != null && !eventType.isBlank()) {
            predicates.add(cb.equal(root.get("eventType"), eventType));
        }
        predicates.add(cb.isFalse(root.get("isDeleted")));
        return cb.and(predicates.toArray(Predicate[]::new));
    };
}

教学点评：

MyBatis 更像“拼 SQL 句子”；
JPA 更像“拼查询对象”；
简单场景都好用，但复杂条件下 MyBatis 调试通常更直接。

3.2 场景 B：复杂报表（CTE + 聚合）

MyBatis

<select id="selectMonthlyWarningStats" resultType="MonthlyWarningStatsDTO">
  WITH sub_regions AS (...),
       monthly_warnings AS (...),
       detailed_data AS (...)
  SELECT ...
  UNION ALL
  SELECT ...
</select>

JPA（一般会用原生 SQL）

public interface FoWarningInfoRepository extends Repository<FoWarningInfoEntity, String> {

    interface MonthlyWarningProjection {
        String getXzqDm();
        String getCityName();
        Long getTotalCount();
        Long getDisposedCount();
        BigDecimal getDisposalRate();
    }

    @Query(value = """
        WITH sub_regions AS (...),
             monthly_warnings AS (...)
        SELECT ...
        """, nativeQuery = true)
    List<MonthlyWarningProjection> selectMonthlyWarningStats(@Param("xzqDm") String xzqDm,
                                                             @Param("eventType") String eventType);
}

教学点评：

这类查询 JPA 最终也常常“回到 SQL”。
如果你的核心价值在复杂查询，MyBatis 的心智模型更稳。

3.3 场景 C：PostgreSQL `jsonb` 字段映射

MyBatis（TypeHandler）

@TableField(value = "original_image", typeHandler = JsonbTypeHandler.class)
private List<Object> originalImage;

#{condition.originalImage, jdbcType=OTHER}::jsonb

JPA（Hibernate 6 示例）

@Entity
@Table(name = "gsmm_warning_info")
public class WarningEntity {

    @Id
    private String id;

    @JdbcTypeCode(SqlTypes.JSON)
    @Column(name = "original_image", columnDefinition = "jsonb")
    private List<Object> originalImage;
}

教学点评：

两者都能做，但 MyBatis 对方言控制更“显式”。
如果你大量使用数据库特性，MyBatis 更少“黑盒感”。

3.4 场景 D：DDD 分层下如何防止 ORM 污染领域

无论你选 JPA 还是 MyBatis，都建议：

domain 层定义 Gateway 接口；
infrastructure 层实现具体持久化；
不让 Entity/DO 直接泄漏到应用层与领域层。

// domain
public interface WarningStrategyGateway {
    List<WarningStrategy> findByTreeId(String treeId);
}

// infrastructure (JPA or MyBatis 都可以是实现细节)
@Service
@RequiredArgsConstructor
public class WarningStrategyGatewayImpl implements WarningStrategyGateway {
    @Override
    public List<WarningStrategy> findByTreeId(String treeId) {
        // 查询 + 转换
        return List.of();
    }
}