本文介紹了一次 MySQL 數據遷移的流程，通過方案選型、業務改造、雙寫遷移最終實現了億級數據的遷移。

一、背景

預約業務是 vivo 游戲中心的重要業務之一。由于歷史原因，預約業務數據表與其他業務數據表存儲在同一個數據庫中。當其他業務出現慢 SQL 等異常情況時，可能會直接影響到預約業務，從而降低系統整體的可靠性和穩定性。為了盡可能提高系統的穩定性和數據隔離性，我們迫切需要將預約相關數據表從原來的數據庫中遷移出來，單獨建立一個預約業務的數據庫。

二、方案選型

常見的遷移方案大致可以分為以下幾類：

而預約業務有以下特點：

讀寫場景多，頻率高，在用戶預約/取消預約/福利發放等場景均涉及到大量的讀寫。

不可接受停機，停機不可避免的會造成經濟損失，在有其他方案的情況下不適合選擇此方案。

大部分的場景能接受秒級的數據不一致，少部分不能。

結合這些特點，我們再評估下上面的方案：

停機遷移方案需要停機，不適用于預約場景。預約場景存在不活躍的用戶數據，如果用漸進式遷移方案的話很難遷移干凈，可能還需要再寫一個遷移任務來輔助完成遷移。而雙寫方案最大的優勢在于每一步操作都可向上回滾，能盡可能的保證業務不出問題。

因此，最終選擇的是雙寫方案。預約業務涉及到的讀寫場景多，每一個場景單獨進行改造的成本大，采用 Mybatis 插件來實現遷移所需的雙寫等功能，可以有效降低改造成本。

三、前期準備

3.1 全量同步&增量同步&一致性校驗

這幾步使用了公司提供的數據同步工具。全量同步基于 MySQLDump 實現；增量同步基于 binlog 實現；一致性校驗通過在新老庫各選一個分塊，然后聚合列數據計算并對比其特征值實現。

3.2 代碼改造

引入了新庫，那自然就需要在項目里新建數據源，并創建表對應的 Mybatis Mapper 類。這里有一個小細節需要注意，Mybatis 默認的 BeanNameGenerator 是

AnnotationBeanNameGenerator，它會使用類名作為 BeanName 注冊到 Spring 的 ioc 容器中，Spring 啟動時如果發現有了兩個重名 Bean 就會啟動失敗，筆者這里給 Mybatis 設置了一個新的 BeanNameGenerator ，使用類的全路徑名作為 BeanName 解決了問題。

public class FullPathBeanNameGenerator implements BeanNameGenerator {
  @Override
  public String generateBeanName(BeanDefinition definition, BeanDefinitionRegistry registry) {
    return definition.getBeanClassName();
  }
}

還有一點是主鍵 id，本次預約遷移需要保證新老庫主鍵 id 一致，預約業務沒做分庫分表，id 都是直接用 MySQL 的自增 id，沒有用 id 生成器之類的中間件。因此插入新表時只需要使用插入老表后 Mybatis 自動設置好的 id 即可，這次遷移前先檢查了一遍業務代碼，確保插入語句都用了 Mybatis 的 useGeneratedKeys 功能來自動設置 id。

3.3 插件實現

Mybatis 插件可以攔截 SQL 語句執行過程中的某一點進行干預和處理，而 Executor 是 Mybatis 中負責執行 SQL 語句的核心組件。我們可以對 Executor 的 update 和 query 方法進行代理以實現遷移所需的功能。

插件需要為讀寫場景分別實現以下功能：

考慮到開關切換部分的代碼邏輯較為簡單，因此在下文中，筆者將不再過多介紹該部分的具體實現，而是著重介紹如何在插件中使用老庫的執行語句來訪問新的數據庫。此外，代碼里會涉及到 Mybatis 相關的一些概念，由于網上已經有較多詳盡的資料，這里就不再贅述。

遷移插件代理了 Executor 的 query 和 update 方法，首先在插件里獲取到當前執行的 SQL 語句所在的 Mapper 路徑。

@Intercepts(
    {
        @Signature(type = Executor.class, method = "update", args = {MappedStatement.class, Object.class}),
        @Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}),
        @Signature(type = Executor.class, method = "query", args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class, CacheKey.class, BoundSql.class}),
    }
)
public class AppointMigrateInterceptor implements Interceptor {
 
  @Override
  public Object intercept(Invocation invocation) throws Throwable {
 
    Object[] args = invocation.getArgs();
    // Mybatis插件代理的Executor的update或者query方法，第一個參數就是MappedStatement
    MappedStatement ms = (MappedStatement) args[0];
    SqlCommandType sqlCommandType = ms.getSqlCommandType();
    String id = ms.getId();
    // 從MappedStatement id中獲取對應的Mapper接口文件全路徑
    String sourceMapper = id.substring(0, id.lastIndexOf("."));
 
    // ...
  }
   
  // ...
}

得到老庫 Mapper 路徑后，將其轉換為新庫 Mapper 路徑，再使用 Class.forName 獲取到新庫 Mapper 類，然后用新庫的 sqlSessionFactory 開啟 sqlSession，再獲取反射調用所需的方法、對象、參數，在新庫上執行語句。

protected Object invoke(Invocation invocation, TableConfiguration tableConfiguration) throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
  // 獲取 MappedStatement
  MappedStatement ms = (MappedStatement) invocation.getArgs()[0];
 
  // 獲取 Mybatis 封裝好的入參，封裝函數 MapperMethod.convertArgsToSqlCommandParam(Object[] args)
  Object parameter = invocation.getArgs()[1];
 
  // 使用 Class.forName 獲取到的新庫 Mapper
  Class targetMapperClass = tableConfiguration.getTargetMapperClazz();
 
  // 使用新庫的 sqlSessionFactory 創建 sqlSession
  SqlSession sqlSession = sqlSessionFactory.openSession();
  Object result = null;
  try{
    // 使用新庫的 Mapper 路徑獲取對應的 MapperProxy 對象
    Object mapper = sqlSession.getMapper(targetMapperClass);
 
    // 將 Mybatis 封裝好的參數轉換為原始參數
    Object[] paramValues = getParamValue(parameter);
 
    // 使用 mappedStatement Id 從新庫對應的 Mapper 里獲取對應的方法
    Method method = getMethod(ms.getId(), targetMapperClass, paramValues);
    paramValues = fixNullParam(method, paramValues);
 
    // 反射調用新庫 Mapper 的方法,本質上執行的是 MapperProxy.invoke
    result = method.invoke(mapper, paramValues);
  } finally {
    sqlSession.close();
  }
  return result;
}
 
private Object[] fixNullParam(Method method, Object[] paramValues) {
  if (method.getParameterTypes().length > 0 && paramValues.length == 0) {
    return new Object[]{null};
  }
  return paramValues;
}

（左右滑動查看更多）

上述代碼里，getMethod 方法負責從新庫 Mapper 類里找到對應的方法，以用于后續的反射調用。

private Method getMethod(String id, Class mapperClass) throws NoSuchMethodException {
  //獲取參數對應的 class
  String methodName = id.substring(id.lastIndexOf(".") + 1);
  String key = id;
  // methodCache 用來緩存 MappedStatement 和對應的 Method，避免每次都從 Mapper 里查找
  Method method = methodCache.get(key);
  if (method == null){
    method = findMethodByMethodSignature(mapperClass, methodName);
    if (method == null){
      throw new NoSuchMethodException("No such method " + methodName + " in class " + mapperClass.getName());
    }
    methodCache.put(key,method);
  }
  return method;
}
 
private Method findMethodByMethodSignature(Class mapperClass,String methodName) throws NoSuchMethodException {
  // mybatis 的 Mapper 內的方法不支持重載，所以這里只要方法名匹配到了就行，不用進行參數的匹配
  Method method = null;
  for (Method m : mapperClass.getMethods()) {
    if (m.getName().equals(methodName)) {
      method = m;
      break;
    }
  }
  return method;
}

得到方法后，還需要得到反射調用所需的參數。Mybatis 執行到 Executor.update/query 方法時，參數已經經過 MapperMethod.convertArgsToSqlCommandParam(Object[] args) 方法封裝，不能直接用來執行 MapperProxy.invoke ，需要轉換后才可用。下圖是MapperMethod.convertArgsToSqlCommandParam(Object[] args) 的封裝過程，而下面的 getParamValue 是這個函數的逆過程。

private Object[] getParamValue(Object parameter) {
  List