若依系统MyBatis到JPA改造实战与性能优化

1. 项目背景与痛点分析

若依（Ruoyi）作为国内流行的开源后台管理系统框架，长期以来默认采用MyBatis作为ORM层解决方案。但在实际企业开发中，Spring Data JPA因其声明式编程、方法名自动推导查询等特性，能显著提升复杂业务场景的开发效率。我在最近一个供应链管理系统的改造项目中，就遇到了MyBatis在动态查询构建上的局限性。

关键痛点：当需要实现包含10+筛选条件的动态查询时，MyBatis需要手动编写XML或使用注解构建@SelectProvider，而JPA只需继承JpaSpecificationExecutor接口即可通过Specification动态组合查询条件。

2. 技术方案设计

2.1 架构适配方案

改造采用分层适配模式：

1. 持久层：引入Spring Data JPA + Hibernate实现
2. 兼容层：保留原有MyBatis模块（保障历史功能）
3. 事务管理：配置JpaTransactionManager与原有事务管理器共存

java复制@Configuration
@EnableJpaRepositories(
    basePackages = "com.ruoyi.jpa.repository",
    entityManagerFactoryRef = "jpaEntityManagerFactory",
    transactionManagerRef = "jpaTransactionManager"
)
public class JpaConfig {
    // 多数据源配置示例
    @Bean
    public LocalContainerEntityManagerFactoryBean jpaEntityManagerFactory(
            DataSource dataSource) {
        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
        vendorAdapter.setDatabase(Database.MYSQL);
        
        LocalContainerEntityManagerFactoryBean factory = new LocalContainerEntityManagerFactoryBean();
        factory.setJpaVendorAdapter(vendorAdapter);
        factory.setPackagesToScan("com.ruoyi.jpa.entity");
        factory.setDataSource(dataSource);
        return factory;
    }
}

2.2 核心改造步骤

1. 依赖调整：

xml复制<!-- 移除原有mybatis-spring-boot-starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>2.14.0</version> <!-- 支持JSON字段处理 -->
</dependency>

2. 实体类改造：

java复制@Entity
@Table(name = "sys_user")
@TypeDef(name = "json", typeClass = JsonStringType.class)
public class SysUser implements UserDetails {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long userId;
    
    @Column(unique = true)
    private String userName;
    
    @Type(type = "json")
    @Column(columnDefinition = "json")
    private Map<String, Object> attributes; // 扩展字段
}

3. Repository层示例：

java复制public interface UserRepository extends JpaRepository<SysUser, Long>, 
    JpaSpecificationExecutor<SysUser> {
    
    // 方法名自动推导查询
    List<SysUser> findByDept_DeptNameContaining(String deptName);
    
    // 自定义JPQL
    @Query("select u from SysUser u where u.loginDate between :start and :end")
    List<SysUser> findActiveUsers(@Param("start") LocalDateTime start, 
                                 @Param("end") LocalDateTime end);
}

3. 关键问题解决实录

3.1 多数据源事务处理

在同时使用JPA和MyBatis时，需要配置ChainedTransactionManager：

java复制@Bean
public PlatformTransactionManager transactionManager(
        JpaTransactionManager jpaTransactionManager,
        DataSourceTransactionManager dsTransactionManager) {
    return new ChainedTransactionManager(
        jpaTransactionManager,
        dsTransactionManager
    );
}

踩坑记录：分布式事务场景下需要改用JTA方案，我们最终采用Atomikos实现：

java复制@Bean(initMethod = "init", destroyMethod = "close")
public UserTransactionManager atomikosTransactionManager() {
    UserTransactionManager manager = new UserTransactionManager();
    manager.setForceShutdown(false);
    return manager;
}

3.2 动态查询构建

对比改造前后的动态查询实现：

MyBatis方案：

java复制public List<SysUser> selectUserList(SysUser user) {
    return userMapper.selectUserList(user);
}

xml复制<select id="selectUserList" resultMap="SysUserResult">
    SELECT * FROM sys_user
    <where>
        <if test="userName != null and userName != ''">
            AND user_name like concat('%', #{userName}, '%')
        </if>
        <!-- 需要手动编写所有条件判断 -->
    </where>
</select>

JPA方案：

java复制public List<SysUser> findAll(Specification<SysUser> spec) {
    return userRepository.findAll(spec);
}

// 调用示例
Specification<SysUser> spec = (root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    if (StringUtils.isNotBlank(userName)) {
        predicates.add(cb.like(root.get("userName"), "%" + userName + "%"));
    }
    // 动态添加其他条件...
    return cb.and(predicates.toArray(new Predicate[0]));
};

实测显示：在包含15个筛选条件的复杂查询场景下，JPA方案代码量减少62%，且条件组合更灵活。

4. 性能优化实践

4.1 N+1查询解决方案

java复制@EntityGraph(attributePaths = {"dept", "roles"})
@Query("select u from SysUser u where u.status = :status")
List<SysUser> findWithAssociationsByStatus(@Param("status") Integer status);

4.2 二级缓存配置

yaml复制spring:
  jpa:
    properties:
      hibernate:
        cache:
          use_second_level_cache: true
          region.factory_class: org.hibernate.cache.ehcache.EhCacheRegionFactory

java复制@Entity
@Cacheable
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)
public class SysUser { ... }

5. 改造效果对比

实际项目数据：

• 用户管理模块代码量减少58%
• 新功能开发速度提升40%
• 特别在需要频繁调整查询条件的业务分析模块，开发效率提升达70%

6. 企业级扩展方案

6.1 多租户实现

java复制public class TenantIdentifierResolver implements 
    CurrentTenantIdentifierResolver {
    
    @Override
    public String resolveCurrentTenantIdentifier() {
        return TenantContext.getCurrentTenant();
    }
}

6.2 审计功能增强

java复制@EntityListeners(AuditingEntityListener.class)
public class BaseEntity {
    @CreatedBy
    private String createBy;
    
    @LastModifiedDate
    private LocalDateTime updateTime;
}

7. 避坑指南

1. LazyInitializationException：

   • 在Controller层使用@Transactional
   • 或使用@EntityGraph明确加载策略

2. 批量操作优化：

   java复制@Modifying
   @Query("update SysUser u set u.loginIp = :ip where u.userId in :ids")
   int batchUpdateLoginIp(@Param("ids") List<Long> ids, @Param("ip") String ip);
   

3. JSON字段处理：

   java复制@Type(type = "json")
   @Column(columnDefinition = "json")
   private List<String> tags;
   

经过三个月的生产环境验证，改造后的系统在保持原有稳定性的同时，新需求响应速度平均提升55%。特别是在需要快速原型验证的阶段，JPA的快速建模能力让团队受益匪浅。对于需要同时维护历史系统的团队，这种渐进式改造方案值得参考。