服务注册与分布式协调 / 系统课时
切换外置数据库保存系统数据
切换外置数据库保存系统数据
内置存储适合快速验证,但生产环境需要把持久化数据放到可备份、可审计的外置数据库。本节以 Nacos 3.x 发行包和 MySQL 为例,完成 Schema 初始化、数据源切换、既有配置迁移,并验证重启后配置仍然存在。
学习目标
- 能初始化 Nacos 所需的 MySQL Schema,并配置外置数据源。
- 能在切换前备份既有配置,避免把“换数据库”误当成“自动迁移”。
- 能通过重启验证配置确实由外置数据库持久化。
切换前确认迁移边界
修改数据源配置只会改变 Nacos 之后读写的位置,不会自动把旧的 Derby 数据复制到 MySQL。已有环境应安排维护窗口,先备份可迁移数据,再初始化目标库并切换;配置数据可以使用 Nacos 的导出与导入能力迁移。
本地用户、角色和权限等鉴权数据不包含在配置 ZIP 中。若目标库是全新 Schema,应在切换后按既定账号与权限清单重新初始化,或使用经过同版本验证的数据库迁移方案,不能只复制几张表就假定系统状态完整。

初始化 MySQL Schema
先让数据库管理员准备专用账号与目标库,再使用发行包自带的 conf/mysql-schema.sql 初始化表结构。下面命令中的 <DB_HOST>、<DB_PORT>、<DB_ADMIN_USER> 与 <PATH> 都要替换成实际值。
set -euo pipefail
DB_HOST='<DB_HOST>'
DB_PORT='<DB_PORT>'
DB_ADMIN='<DB_ADMIN_USER>'
NACOS_HOME='<PATH>'
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_ADMIN" -p -e "CREATE DATABASE IF NOT EXISTS nacos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" >/dev/null
mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_ADMIN" -p nacos < "$NACOS_HOME/conf/mysql-schema.sql" >/dev/null
TABLE_OK="$(mysql -h "$DB_HOST" -P "$DB_PORT" -u "$DB_ADMIN" -p -Nse "SELECT COUNT(*) FROM information_schema.tables WHERE table_schema='nacos' AND table_name='config_info';")"
printf 'config_info_table=%s\n' "$TABLE_OK"预期输出
config_info_table=1看到 1 说明核心配置表已经创建。生产环境不要让 Nacos 使用数据库管理员账号,应该使用只对 nacos 库具有所需权限的专用账号,并把密码交给部署系统或密钥系统管理。
配置 Nacos 使用外置数据库
修改 <PATH>/conf/application.properties。下面使用 Nacos 3.x 新部署常用的 spring.sql.init.platform 与 db.* 配置,并通过环境变量注入数据库账号密码。
spring.sql.init.platform=mysql
db.num=1
db.url.0=jdbc:mysql://<DB_HOST>:<DB_PORT>/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user=${MYSQL_USER}
db.password=${MYSQL_PASSWORD}
db.pool.config.connectionTimeout=3000
db.pool.config.maximumPoolSize=20这份配置生效后,Nacos 的持久化 SQL 会发往 MySQL。若是多节点集群,所有节点必须使用同一套数据库地址、Schema 和凭据来源;不要让部分节点仍指向内置存储。
迁移既有配置
切换前可先从旧 Nacos 导出配置。下面示例以 public 命名空间为例,要求默认 Nacos 鉴权或 LDAP 鉴权可通过用户名密码登录,并已安装 curl 与 jq。<NACOS_PASSWORD> 和 <PATH> 需要替换。
set -euo pipefail
NACOS='http://127.0.0.1:8848'
NACOS_USER='nacos'
NACOS_PASSWORD='<NACOS_PASSWORD>'
BACKUP='<PATH>/public-config.zip'
TOKEN="$(curl -fsS -X POST "$NACOS/nacos/v3/auth/user/login" -d "username=$NACOS_USER&password=$NACOS_PASSWORD" | jq -r '.accessToken')"
curl -fsS -G "$NACOS/nacos/v3/admin/cs/config/export" -H "Authorization: Bearer $TOKEN" --data-urlencode 'namespaceId=public' --data-urlencode 'ids=' -o "$BACKUP"
test -s "$BACKUP" && echo 'backup-ready'预期输出
backup-ready有多个命名空间时要逐个导出并记录对应 Namespace ID。完成 MySQL 切换并初始化新环境的管理员身份后,再把 ZIP 导入原来的命名空间;导入前先确认冲突策略,避免误覆盖已经在新库产生的配置。
set -euo pipefail
NACOS='http://127.0.0.1:8848'
NACOS_USER='nacos'
NACOS_PASSWORD='<NACOS_PASSWORD>'
BACKUP='<PATH>/public-config.zip'
TOKEN="$(curl -fsS -X POST "$NACOS/nacos/v3/auth/user/login" -d "username=$NACOS_USER&password=$NACOS_PASSWORD" | jq -r '.accessToken')"
curl -fsS -X POST "$NACOS/nacos/v3/admin/cs/config/import" -H "Authorization: Bearer $TOKEN" -F 'namespaceId=public' -F 'policy=ABORT' -F "file=@$BACKUP" | jq -e '.code == 0' >/dev/null
echo 'import-ok'预期输出
import-ok重启验证持久化结果
最后不要只看“服务启动成功”,而要写入一条测试配置、重启 Nacos,再重新读取它。下面示例假定数据库环境变量会随 Nacos 进程启动时注入,且默认鉴权已可登录。
set -euo pipefail
NACOS_HOME='<PATH>'
NACOS='http://127.0.0.1:8848'
NACOS_USER='nacos'
NACOS_PASSWORD='<NACOS_PASSWORD>'
export MYSQL_USER='nacos'
export MYSQL_PASSWORD='<DB_PASSWORD>'
TOKEN="$(curl -fsS -X POST "$NACOS/nacos/v3/auth/user/login" -d "username=$NACOS_USER&password=$NACOS_PASSWORD" | jq -r '.accessToken')"
curl -fsS -X POST "$NACOS/nacos/v3/admin/cs/config" -H "Authorization: Bearer $TOKEN" -d 'namespaceId=public' -d 'groupName=DEFAULT_GROUP' -d 'dataId=storage-check.properties' --data-urlencode 'content=storage=external-mysql' | jq -e '.data == true' >/dev/null
bash "$NACOS_HOME/bin/shutdown.sh" >/dev/null 2>&1
sleep 5
bash "$NACOS_HOME/bin/startup.sh" -m standalone >/dev/null 2>&1
for _ in $(seq 1 30); do
if curl -fsS -G "$NACOS/nacos/v3/client/cs/config" -H "Authorization: Bearer $TOKEN" --data-urlencode 'namespaceId=public' --data-urlencode 'groupName=DEFAULT_GROUP' --data-urlencode 'dataId=storage-check.properties' -o /tmp/nacos-storage-check.json 2>/dev/null; then
break
fi
sleep 2
done
jq -r '.data.content' /tmp/nacos-storage-check.json预期输出
storage=external-mysql如果重启后读取不到这条配置,优先检查数据库连通性、Schema 是否完整、Nacos 启动进程是否拿到了 MYSQL_USER 与 MYSQL_PASSWORD,以及是否仍有更高优先级的启动参数覆盖 application.properties。只有写入、重启、再次读取三步都通过,才能认为外置数据库切换完成。