nacos集群必须用mysql做外部存储,否则节点间配置和注册信息不一致;单机可用derby,但集群下各节点derby数据完全隔离、无法同步,导致服务发现失败与配置不一致,官方明确仅支持mysql集中存储。

直接上结论:Nacos集群必须用MySQL做外部存储,否则节点间配置和注册信息不一致;单机用Derby能跑,集群一启动就丢数据。
为什么必须换MySQL?Derby在集群里根本不可用
Derby是嵌入式数据库,每个Nacos进程自带一个独立实例。集群下三个节点各自写自己的Derby,服务注册、配置发布全不同步——你往nacos01注册的服务,在nacos02查不到;改了个配置,只在当前节点生效。这不是高可用,是高分裂。
- 官方明确说明:集群模式仅支持MySQL集中存储,Derby仅限单机测试
- MySQL版本要求5.6.5+(推荐8.0),字符集必须为
utf8mb4,否则中文乱码或插入失败 - 表结构必须用Nacos自带的初始化脚本,不能手动建空库——
nacos-mysql.sql(旧版)或mysql-schema.sql(新版)都行,但得执行完整
cluster.conf 和 application.properties 怎么配才不翻车
这两个文件是集群通信和数据源的命脉,错一个字符就起不来。
-
cluster.conf每行一个节点,格式严格为IP:PORT(不能带http://,不能有空格),例如:192.168.159.33:3333、192.168.159.33:4444、192.168.159.33:5555;注释行必须以#开头且独占一行 -
application.properties里关键项必须全部存在且顺序无关,但db.url.0必须带useSSL=false(MySQL 8.0+默认强制SSL),还要加serverTimezone=UTC,否则连接报错The server time zone value 'XXX' is unrecognized - 示例片段:
spring.sql.init.platform=mysql db.num=1 db.url.0=jdbc:mysql://192.168.159.33:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false&serverTimezone=UTC&allowMultiQueries=true db.user=nacos db.password=nacos
- 所有节点的
db.user和db.password必须完全一致;db.url.0指向同一个MySQL实例,不是各连各的库
启动命令和端口暴露容易漏掉的关键点
集群启动不是简单./startup.sh -m cluster,gRPC端口没开,客户端连不上。
- 必须显式指定
-Dnacos.standalone=false,否则即使有cluster.conf也走单机模式 - 每个节点启动前要确认
server.port(如3333/4444/5555)和nacos.server.port(同前者)一致,否则控制台显示端口错乱 - 除了主端口(如8848),
9848(客户端gRPC)、9849(服务端gRPC)、7848(JRaft)必须在防火墙放行;用VIP或Nginx时,只转发8848和9848,9849和7848严禁暴露到公网 - Nginx做负载时,必须用
stream模块做TCP透传,不能用http模块——否则gRPC长连接被断开,客户端反复重连
鉴权开启后登录失败的典型原因
Nacos 3.0+ 默认启用控制台鉴权,不配就进不去页面,且错误提示极不友好(只显示“用户名或密码错误”)。
- 必须在
application.properties中同时设置以下三项,缺一不可:
nacos.core.auth.enabled=true nacos.core.auth.console.enabled=true nacos.core.auth.system.type=nacos
-
nacos.core.auth.plugin.nacos.token.secret.key值必须32位以上,且所有节点完全一致;建议用openssl rand -hex 32生成 - 首次登录用默认账号
nacos/nacos,但前提是nacos.core.auth.system.type=nacos已生效;如果配了其他type(如ldap),默认账号无效 - 修改完配置后必须重启节点,热加载不生效
最常被忽略的是:MySQL初始化脚本执行后,没给nacos用户授予nacos_config库的全部权限,导致启动日志里静默报Access denied for user,但进程仍显示“started”。











