最近試用了MeterSphere做接口測試平臺,感覺使用起來非常方便,最重要的是開源免費!官方文檔還是非常詳細的,這里我就不多介紹了,感興趣的同學可以參考:
https://metersphere.io/docs/v2.x/
經過討論,決定在測試團隊推廣。由于公司數據庫管理策略,數據庫必須通過dba 統一管理,所以需要MeterSphere連接外部mysql數據庫。數據庫遷移過程中主要遇到下面錯誤:
Caused by: org.flywaydb.core.api.FlywayException: Schema `metersphere` contains a failed migration to version 5 !
接下來我就詳細講述一下,MeterSphere連接外部數據庫的操作過程,以及再此過程中解決遇到問題的詳細步驟:
修改配置文件
根據官方提示 在/opt/metersphere/.env (該文件是隱藏文件)中修改如下配置,注意標紅
# 數據庫配置
## 是否使用外部數據庫
MS_EXTERNAL_MYSQL=true
## 數據庫地址
MS_MYSQL_HOST=mysql
## 數據庫端口
MS_MYSQL_PORT=3306
## 數據庫庫名
MS_MYSQL_DB=metersphere
## 數據庫用戶名
MS_MYSQL_USER=root
## 數據庫密碼
MS_MYSQL_PASSWORD=Password123@mysql
然后運行命令
msctl reload
msctl restart
錯誤現象
自以為會是大功告成,事實則是登錄無反應!
查看/opt/metersphere/logs/metersphere/info.log 日志發現問題如下:
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
第一反應是 — 怎么會?我明明按照官網鏈接一步一步執行的啊!
https://metersphere.io/docs/v2.x/installation/offline_installation/
并協調dba搞了個MySQL5.7 ,怎么還會報db遷移到5的錯誤呢?
Caused by: org.flywaydb.core.api.FlywayException: Schema `metersphere` contains a failed migration to version 5 !
尋求問題解決方案
于是乎找了metersphere的技術支持,解決方案如下:
首先執行下面的腳本
https://raw.githubusercontent.com/metersphere/metersphere/master/backend/src/main/resources/db/migration/V5__schedule.sql
然后修改metersphere_version 表對應版本的的success值為1,
最后執行命令 msclt reload 重啟服務即可
1.這里需要注意的是:執行V5__schedule.sql語句一定讓dba找一個最高權限的賬號來執行,否者需要各種授權,非常的麻煩!
2.如果執行過程中有各種表已經創建,列已經存在的相關消息,直接忽略即可
3. V5__schedule.sql 執行之前已經執行了很多sql操作,這些語句是在執行下面語句時就已經完成了的!換句話說,V5__schedule.sql是基于下面的語句運行之后再運行的!
msctl reload
msctl restart
最后的總結
如果執行sql語句過程中出現了意想不到的問題。建議如下操作:
1. 刪掉庫metersphere,然后重新創建庫metersphere
2. 執行msctl restart
3. 執行語句V5__schedule.sql
4. 修改metersphere_version 表對應版本的的success值為1
5. 執行msclt reload