JPA如何使用同一实体映射运行时动态指定的版本表名

核心逻辑非常统一：给实体类绑定固定的逻辑表名占位符，运行时根据动态拿到的版本号，在SQL生成/执行阶段把占位符替换成真实物理表名，完全不需要为每个版本表单独建实体类，主流ORM框架都提供了对应的扩展点，不需要硬编码全量SQL拼接。

MyBatis/MyBatis-Plus 实现（国内业务最常用） #

• 如果用MyBatis-Plus，直接用框架自带的动态表名拦截器即可：
  1. 给通用实体类加固定表名注解@TableName("table_ver_placeholder")，正常写BaseMapper、Service层的CRUD逻辑，完全不用考虑表名差异。
  2. 实现DynamicTableNameInnerInterceptor的表名替换逻辑：用ThreadLocal或者请求作用域的上下文存当前操作的版本号，拦截器检测到当前操作的是占位符表时，直接把表名替换为table_ + 补零到4位的版本号，比如版本号为3就替换成table_0003。
     核心替换逻辑参考：

  // 提前在上下文存入当前请求要操作的版本号
  Integer currentVersion = VersionContext.getCurrentVersion();
  if ("table_ver_placeholder".equals(originalTableName)) {
      return String.format("table_%04d", currentVersion);
  }
  return originalTableName;
  

• 如果用原生MyBatis没有插件，也可以直接在Mapper XML的SQL语句里用占位符拼接表名，注意必须对传入的版本号做严格校验：只允许4位纯数字、提前校验对应版本表存在，杜绝SQL注入风险。
  示例写法：

  <select id="selectData" resultType="com.xxx.TableEntity">
      select * from table_${tableSuffix}
      where biz_id = #{bizId}
  </select>
  

JPA/Hibernate 实现 #

• 可以自定义Hibernate的StatementInspector拦截器，在SQL生成后、执行前拦截SQL字符串，和MyBatis拦截器逻辑一致，从上下文读取当前版本号，替换SQL里的逻辑表名为真实版本表名即可，实体类只需要绑定固定的逻辑表名，不需要做其他改动。
• 也可以实现自定义的PhysicalNamingStrategy，在表名解析阶段根据上下文的版本号动态返回真实物理表名，逻辑完全相通。

落地注意事项 #

• 所有传入的动态表名后缀必须做白名单校验，绝对不能直接把未校验的外部入参拼到SQL里，避免SQL注入。
• 如果用到线程池、异步任务，要注意把上下文里存储的版本号透传到子线程，避免表名替换错误。
• 如果需要跨多个版本做聚合查询，直接在SQL里用UNION ALL拼接对应版本的物理表即可，不需要调整实体类配置。

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