最近試用了MeterSphere做接口測試平臺，感覺使用起來非常方便，最重要的是開源免費(fèi)！官方文檔還是非常詳細(xì)的，這里我就不多介紹了，感興趣的同學(xué)可以參考：
https://metersphere.io/docs/v2.x/
經(jīng)過討論，決定在測試團(tuán)隊(duì)推廣。由于公司數(shù)據(jù)庫管理策略，數(shù)據(jù)庫必須通過dba 統(tǒng)一管理，所以需要MeterSphere連接外部mysql數(shù)據(jù)庫。數(shù)據(jù)庫遷移過程中主要遇到下面錯誤：
Caused by: org.flywaydb.core.api.FlywayException: Schema `metersphere` contains a failed migration to version 5 !
接下來我就詳細(xì)講述一下，MeterSphere連接外部數(shù)據(jù)庫的操作過程，以及再此過程中解決遇到問題的詳細(xì)步驟：
修改配置文件
根據(jù)官方提示 在/opt/metersphere/.env （該文件是隱藏文件）中修改如下配置，注意標(biāo)紅
# 數(shù)據(jù)庫配置
## 是否使用外部數(shù)據(jù)庫
MS_EXTERNAL_MYSQL=true
## 數(shù)據(jù)庫地址
MS_MYSQL_HOST=mysql
## 數(shù)據(jù)庫端口
MS_MYSQL_PORT=3306
## 數(shù)據(jù)庫庫名
MS_MYSQL_DB=metersphere
## 數(shù)據(jù)庫用戶名
MS_MYSQL_USER=root
## 數(shù)據(jù)庫密碼
MS_MYSQL_PASSWORD=Password123@mysql
然后運(yùn)行命令
msctl reload
msctl restart
錯誤現(xiàn)象
自以為會是大功告成，事實(shí)則是登錄無反應(yīng)！
查看/opt/metersphere/logs/metersphere/info.log 日志發(fā)現(xiàn)問題如下：
Caused by: org.flywaydb.core.api.FlywayException: Schema `metersphere` contains a failed migration to version 5 !
at org.flywaydb.core.internal.command.DbMigrate.migrateGroup(DbMigrate.java:217)
at org.flywaydb.core.internal.command.DbMigrate.lambda$migrateAll$0(DbMigrate.java:141)
at org.flywaydb.core.internal.database.mysql.MySQLNamedLockTemplate.execute(MySQLNamedLockTemplate.java:60)
at org.flywaydb.core.internal.database.mysql.MySQLConnection.lock(MySQLConnection.java:154)
at org.flywaydb.core.internal.schemahistory.JdbcTableSchemaHistory.lock(JdbcTableSchemaHistory.java:141)
at org.flywaydb.core.internal.command.DbMigrate.migrateAll(DbMigrate.java:141)
at org.flywaydb.core.internal.command.DbMigrate.migrate(DbMigrate.java:101)
at org.flywaydb.core.Flyway$1.execute(Flyway.java:219)
at org.flywaydb.core.Flyway$1.execute(Flyway.java:170)
at org.flywaydb.core.Flyway.execute(Flyway.java:586)
at org.flywaydb.core.Flyway.migrate(Flyway.java:170)
at org.springframework.boot.autoconfigure.flyway.FlywayMigrationInitializer.afterPropertiesSet(FlywayMigrationInitializer.java:66)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1863)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1800)
... 34 common frames omitted
第一反應(yīng)是 — 怎么會？我明明按照官網(wǎng)鏈接一步一步執(zhí)行的?。?/p>
https://metersphere.io/docs/v2.x/installation/offline_installation/
并協(xié)調(diào)dba搞了個MySQL5.7 ，怎么還會報(bào)db遷移到5的錯誤呢？
Caused by: org.flywaydb.core.api.FlywayException: Schema `metersphere` contains a failed migration to version 5 !
尋求問題解決方案
于是乎找了metersphere的技術(shù)支持，解決方案如下：
首先執(zhí)行下面的腳本
https://raw.githubusercontent.com/metersphere/metersphere/master/backend/src/main/resources/db/migration/V5__schedule.sql
然后修改metersphere_version 表對應(yīng)版本的的success值為1，
最后執(zhí)行命令 msclt reload 重啟服務(wù)即可
1.這里需要注意的是：執(zhí)行V5__schedule.sql語句一定讓dba找一個最高權(quán)限的賬號來執(zhí)行，否者需要各種授權(quán)，非常的麻煩！
2.如果執(zhí)行過程中有各種表已經(jīng)創(chuàng)建，列已經(jīng)存在的相關(guān)消息，直接忽略即可
3. V5__schedule.sql 執(zhí)行之前已經(jīng)執(zhí)行了很多sql操作，這些語句是在執(zhí)行下面語句時就已經(jīng)完成了的！換句話說，V5__schedule.sql是基于下面的語句運(yùn)行之后再運(yùn)行的！
msctl reload
msctl restart
最后的總結(jié)
如果執(zhí)行sql語句過程中出現(xiàn)了意想不到的問題。建議如下操作：
1. 刪掉庫metersphere，然后重新創(chuàng)建庫metersphere
2. 執(zhí)行msctl restart
3. 執(zhí)行語句V5__schedule.sql
4. 修改metersphere_version 表對應(yīng)版本的的success值為1
5. 執(zhí)行msclt reload
