幸运小姐这几年聊到微服务，注册中心绕不开 Nacos。我在自己电脑上第一次用 Docker 启动安装 Nacos 的时候，原本以为无非是 docker run 一把梭，结果实际踩了一串坑：Docker Desktop 启动时报虚拟化没有开启、拉镜像慢到怀疑人生、容器起来之后控制台白屏、想用 MySQL8.0 持久化又提示表不存在，再到后面 namespace 一直为 null，配置总是不生效。这篇内容我会把完整链路摊开讲：Docker 环境怎么准备、Nacos 镜像怎么拉、单机版怎么启动、MySQL8.0 怎么对接、namespace 怎么配、典型报错怎么排查，顺便把服务注册发现、配置中心、Dubbo 接入这些常遇到的问题一起说清楚。文章按我实际踩坑的顺序来写，适合正打算做 nacos 安装配置和部署教程功课的读者，你说它是操作手册也好，排查笔记也罢，能帮你少走弯路就够了。
1. 动手前先弄明白：Nacos 解决什么问题，为什么建议放 Docker
1.1 Nacos 是一个“注册中心 + 配置中心”的组合
Nacos 是阿里巴巴开源的服务发现与配置管理产品。很多人第一次听到“注册中心”这个概念一脸懵，我用比较直白的方式解释：在微服务架构里，服务提供方会不停地变化实例数量，服务调用方不能把地址写死在配置文件里，否则服务一扩容、一宕机就全乱套。Nacos 提供了一个“通讯录”，每个服务启动后把自己的 IP 和端口登记上去，调用方过来查询，就能找到当前可用的提供方列表。
配置中心这部分就更日常了。原来我们改配置要重新打包、重启应用，后来把配置从代码中抽出来，放到一个统一的地方管理，应用启动时去拉取，运行中还能实时感知变化，这就是 Nacos 配置中心的核心价值。Nacos 同时具备这两个能力，很多团队用它替换掉 Eureka、Consul、Apollo 等多个组件，这也是它这些年越来越普及的原因。
1.2 Docker 部署 Nacos 比直接解压安装好在哪
在 Windows 上部署 Nacos，最传统的方式是去 GitHub 下载安装包，解压后修改 application.properties，再执行 startup.cmd -m standalone。这种方式本身没问题，但有三个让人头疼的地方：第一，卸载不干净，配置散落在各个目录；第二，本机可能要同时维护 Nacos 1.x、2.x 多个版本，如果某些老项目还用了不同 MySQL 版本，环境容易乱；第三，在不同电脑上重复部署时，操作步骤可能凭记忆，很容易漏掉参数。
Docker 的作用是标准化。Nacos 镜像里已经装好了运行所需的 JDK 和脚本，只需要关心端口、环境变量、数据卷这几个维度。团队内部如果统一使用 Docker，那么一个人调试好的启动命令，其他人直接复制执行，结果可以保持一致。这不代表 Docker 没有缺点，比如网络模型、端口映射、容器 IP 问题会带来新概念，但整体收益还是远大于学习成本。
1.3 先确认三种运行模式，后面看命令才不懵
Nacos 支持单机模式和集群模式。单机模式适合开发测试，集群模式适合生产环境。从数据存储角度看又可以分成两种：不配置 MySQL 时，Nacos 使用内嵌的 Derby 数据库；配置了 MySQL，则所有配置、服务注册数据会持久化到 MySQL 中。这里的模式和数据库是两个不同维度的选择，可以组合使用，比如单机模式 + MySQL，也可以集群模式 + MySQL。
在展开具体命令前先记住这个结论：本地快速试玩，可以直接用内嵌 Derby，但想做正经项目，建议从第一天就配上 MySQL8.0，否则后面切库迁移脚本也是一件麻烦事。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Docker Desktop 装不起来，多数卡在虚拟化、WSL2、镜像加速
2.1 Docker Desktop 启动失败，报 virtualization support 的完整排查链路
在 Windows 上启动 Docker Desktop 时，最常见的一个弹窗就是 Docker Desktop failed to start because virtualisation support wasn't detected。这个报错出现后，我不会直接去卸载重装，而是按下面的链路逐步排查，每一步都有明确目的：
第一步，打开任务管理器，切到“性能”标签，看右下角“虚拟化”是否为“已启用”。如果显示“已禁用”，说明 BIOS/UEFI 里没有打开 CPU 虚拟化。需要重启电脑，进 BIOS 设置找到 Intel VT-x 或 AMD SVM 选项，把它开启。这一步是所有后续操作的基础，虚拟化没开，Docker Desktop 连创建 Linux 虚拟机的能力都没有。
第二步，在 Windows 功能里勾选“虚拟机平台”和“适用于 Linux 的 Windows 子系统”，然后重启系统。Docker Desktop 在 Windows 上依赖 WSL2，WSL2 本身需要一个轻量级虚拟机，如果缺少“虚拟机平台”组件，WSL2 根本无法运行。
第三步，打开 PowerShell，执行 wsl --install 安装或更新 WSL。如果系统比较老，还可能需要手动下载 WSL2 内核更新包。安装完成后执行 wsl -l -v，查看发行版的版本号，必须确认是 2，如果显示 1，需要执行 wsl --set-version <发行版名称> 2 做转换。Docker Desktop 要求 WSL2，是因为它相比 WSL1 提供了完整的 Linux 内核支持，Docker 容器才能真正跑起来。
走完这三步，再启动 Docker Desktop，绝大多数 virtualization 报错都能解决。我在帮同事排查时还遇到过另一种情况：报错信息一样，但任务管理器显示虚拟化早已开启，最后发现是电脑上安装了第三方虚拟机软件，和 Hyper-V 抢占资源导致冲突，停用那个软件后 Docker 立刻正常。
2.2 docker 镜像下载慢，先把镜像加速配好
Docker 装好后，很多人第一次拉镜像就被网络教育了。默认源在海外的场景下，拉取 Nacos 镜像经常停在等待状态，进度条一动不动。这个问题在拉取任何大型镜像时都会出现，解决办法是给 Docker 配置镜像加速。
在 Docker Desktop 中，进入 Settings -> Docker Engine，可以看到一个 JSON 格式的配置文件，把 registry-mirrors 加入进去：
json复制{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://dockerproxy.com",
"https://docker.1panel.live"
]
}
保存后 Docker Desktop 会自动重启进程。Linux 环境下则要修改 /etc/docker/daemon.json，然后执行 systemctl daemon-reload && systemctl restart docker。配置完成后，可以用 docker info 命令检查，输出中的 Registry Mirrors 列表里能看到刚才添加的地址，说明加速生效。
镜像加速并不是把所有镜像都变成秒下，但在多数情况下，拉取速度能从“无法忍受”提升到“可以等待”。如果某个源不稳定，建议配置两到三个备用源，Docker 会在主源失败后自动尝试其他源。
2.3 验证 Docker 环境是否正常的三个命令
配置完 Docker 后，不急着拉 Nacos，先用三条命令快速验证环境：
bash复制docker version
docker ps
docker info
docker version 会分别显示 Client 和 Server 信息。如果只看到 Client，没有 Server 部分，说明 Docker 引擎没有启动，后续所有命令都会失败。docker ps 用来查看当前运行中的容器，新环境通常返回空列表，这是正常的。docker info 用来查看 Docker 的整体状态，包括容器数量、镜像数量、存储驱动、镜像加速配置等。
如果这三条命令都正常，说明 Docker 环境已经可用，然后放心进入 Nacos 安装环节。这也避免把 Docker 本身的问题和 Nacos 问题混在一起排查。
3. 单机版 Nacos 启动：一条 docker run 背后的参数必须逐项理解
3.1 镜像版本怎么选，为什么我不建议直接 latest
拉取 Nacos 镜像前，先解决版本选择问题。直接在 Docker Hub 搜索 nacos/nacos-server，会看到很多 tag，常见的有 v1.4.x、v2.2.3、v2.3.x、v2.4.x 等。我的建议是不要用 latest，因为 latest 会随着官方发版变化，今天能启动的配置，过几个月可能因为环境变量不兼容而失效。
Nacos 从 2.x 开始引入了 gRPC 通信机制，服务注册、配置监听、服务发现等核心链路都从 HTTP 长轮询迁移到了 gRPC。如果一个项目准备长期使用，我建议选择 2.2.3 或更新的 2.3.x/2.4.x 版本。1.4.x 虽然也还有人用，但缺少后续的新特性和一部分安全修复，新项目没必要从老版本开始。
另外注意一点：网上有人搜“nacos 2.5.4 的 pom 配置”，这里很可能说的是 Java 客户端 nacos-client 的版本，和服务器端镜像 tag 不完全是一回事。服务器端与客户端的版本不需要完全相同，但也不要差距太大。后面第 7 部分讲服务接入时会再提到版本兼容的问题。
3.2 用 docker run 启动一个最简 Nacos 并逐项拆解参数
最简启动命令如下，适合本地开发快速验证：
bash复制docker run -d \
--name nacos-server \
-p 8848:8848 \
-p 9848:9848 \
-p 9849:9849 \
-e MODE=standalone \
-e NACOS_AUTH_ENABLE=true \
-e NACOS_AUTH_TOKEN=U0VDUkVULUtFWS1OQUNPUy1DSEFOR0UtTUUxMjM0NTY3ODkw \
-e NACOS_AUTH_IDENTITY_KEY=serverIdentity \
-e NACOS_AUTH_IDENTITY_VALUE=security \
--restart=always \
nacos/nacos-server:v2.2.3
逐个解释这些参数：
-d 表示容器在后台运行。--name nacos-server 给容器起了一个固定的名字，方便后续用 docker logs nacos-server 查看日志、用 docker restart nacos-server 重启。-p 8848:8848 把容器内 Nacos HTTP 端口映射到宿主机，控制台和客户端 HTTP 请求都走这个端口。-p 9848:9848 是 Nacos 2.x 客户端 gRPC 端口，-p 9849:9849 是服务端之间通信使用的 gRPC 端口。这两件事很关键，很多同学启动容器后把服务注册进去，客户端报错连接不上，最后发现是只映射了 8848，没有映射 9848。9848 和 9849 的规律是主端口 +1000 和 +1001，改变映射时必须保持这个偏移关系。
-e MODE=standalone 设置 Nacos 以单机模式启动。注意，这个环境变量和“是否使用 MySQL”无关，它只控制集群模式还是单机模式。-e NACOS_AUTH_ENABLE=true 开启鉴权。从安全角度考虑，即使本地开发我也建议默认开启，否则任何能访问你 8848 端口的人都能查看控制台数据。NACOS_AUTH_TOKEN 是用于身份校验的密钥，必须是经过 Base64 编码的字符串且长度不少于 32 字节，这里的值是演示用，实际使用必须自己生成一个。NACOS_AUTH_IDENTITY_KEY 和 NACOS_AUTH_IDENTITY_VALUE 是服务端身份标识，同样需要修改为自定义值。--restart=always 让 Docker 在宿主机重启或容器意外退出后自动拉起 Nacos，省去手动启动的麻烦。
Windows 的 cmd 执行上面命令时，把反斜杠 \ 去掉，写成一行即可。
3.3 启动后的验证清单，不要光看容器状态
启动命令执行后，先执行 docker ps 确认容器状态是 Up。但容器状态是 Up 不代表 Nacos 启动成功，因为 Nacos 启动过程需要几十秒，期间容器虽然已经在运行，但内部服务可能还在初始化。
正确的验证方式是看日志：
bash复制docker logs nacos-server
看到包含 Nacos started successfully 的日志，才说明启动完成。如果日志一直停在某个位置，就继续等，不要急着操作。
然后浏览器访问 http://localhost:8848/nacos，会出现控制台登录页，默认用户名和密码都是 nacos。但注意，如果在 3.2 中开启了鉴权，首次登录后建议立刻进入控制台修改默认密码。网上关于 Nacos 未授权访问、任意用户添加等漏洞通报，很多都源于管理员保留了默认账号密码或没有开启鉴权，这些隐患在前期花几秒钟就能避免。
4. 把数据落在 MySQL8.0 里，否则每次重启都是“从零开始”
4.1 内嵌 Derby 和 MySQL 的取舍，别把本地练习和真实需求混为一谈
上一节的最简启动方式使用内嵌 Derby 作为存储，适合第一次体验。但它有两个明显问题：第一，容器一旦被删除，服务注册信息和配置数据全部消失，对应数据卷如果没有备份很难找回；第二，如果以后要搭 Nacos 集群，集群节点之间必须共享同一个数据库，Derby 模式根本无法满足。
这就是为什么真实项目里 Nacos 基本上都会搭配 MySQL。MySQL 在这里承担的是持久化存储角色，Nacos 所有配置、用户、服务注册数据都会写入数据库表。我们接下来用 docker 安装 mysql8.0 并把 Nacos 切换到 MySQL 模式，这套操作在任何一台有 Docker 的机器上都能复现。
4.2 先跑一个 MySQL8.0 容器
启动一个 MySQL8.0 容器，命令如下：
bash复制docker run -d \
--name mysql8 \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=root123456 \
--restart=always \
-v mysql_data:/var/lib/mysql \
mysql:8.0
这里做了三件事：把容器内 3306 映射到宿主机 3306；通过环境变量设置 root 密码；使用 Docker 数据卷 mysql_data 持久化数据库文件，防止容器删除后数据丢失。
MySQL8.0 默认的身份认证插件是 caching_sha2_password，对旧版客户端不太友好。如果你的 Nacos 连接时报认证插件或 Public Key Retrieval 相关错误，最简单的办法是进入 MySQL 容器，创建一个专用账号并指定使用 mysql_native_password 认证方式：
sql复制CREATE DATABASE nacos_config DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'nacos'@'%' IDENTIFIED WITH mysql_native_password BY 'nacos123456';
GRANT ALL PRIVILEGES ON nacos_config.* TO 'nacos'@'%';
FLUSH PRIVILEGES;
'nacos'@'%' 中的 % 表示允许任意主机访问。如果只在本地使用，可以限制为 'nacos'@'localhost' 或 'nacos'@'容器网关IP'，但考虑到 Nacos 在另一个容器中连接时，来源 IP 可能是 172.17.0.x 这种地址，使用 % 可以避免很多网络权限问题。
4.3 导入 Nacos 初始化脚本，表不存在多半是漏了这一步
Nacos 需要使用自己的表结构，官方镜像中其实已经带了初始化脚本，不需要去网上找来历不明的 SQL。在拉取好的镜像基础上，用一条 docker cp 组合命令就可以把脚本取出来：
bash复制docker create --name nacos-tmp nacos/nacos-server:v2.2.3
docker cp nacos-tmp:/home/nacos/conf/mysql-schema.sql ./mysql-schema.sql
docker rm nacos-tmp
docker create 会把镜像实例化为一个容器，但不启动它，所以我们可以安全地从中拷贝文件。把 mysql-schema.sql 拿到宿主机后，再导入到刚才创建的 MySQL 库中：
bash复制docker exec -i mysql8 sh -c 'exec mysql -uroot -proot123456 nacos_config' < ./mysql-schema.sql
执行后可以进入 MySQL 查看表：
bash复制docker exec -it mysql8 mysql -uroot -proot123456
USE nacos_config;
SHOW TABLES;
看到 config_info、service_info、users 等表，就说明初始化成功。很多同学启动 Nacos 后一直报 nacos_config 表不存在或类似错误，根本原因就是数据库建了，但初始化脚本没有导入。
4.4 切到 MySQL 模式启动 Nacos 并解释每个环境变量
有了 MySQL 后，把之前的 Nacos 容器删除，重新启动：
bash复制docker rm -f nacos-server
docker run -d \
--name nacos-server \
-p 8848:8848 \
-p 9848:9848 \
-p 9849:9849 \
-e MODE=standalone \
-e SPRING_DATASOURCE_PLATFORM=mysql \
-e MYSQL_SERVICE_HOST=127.0.0.1 \
-e MYSQL_SERVICE_PORT=3306 \
-e MYSQL_SERVICE_DB_NAME=nacos_config \
-e MYSQL_SERVICE_USER=nacos \
-e MYSQL_SERVICE_PASSWORD=nacos123456 \
-e MYSQL_SERVICE_DB_PARAM="characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai" \
-e NACOS_AUTH_ENABLE=true \
-e NACOS_AUTH_TOKEN=U0VDUkVULUtFWS1OQUNPUy1DSEFOR0UtTUUxMjM0NTY3ODkw \
-e NACOS_AUTH_IDENTITY_KEY=serverIdentity \
-e NACOS_AUTH_IDENTITY_VALUE=security \
--restart=always \
nacos/nacos-server:v2.2.3
SPRING_DATASOURCE_PLATFORM=mysql 告诉 Nacos 不要用内嵌 Derby，而是使用外部数据库。MYSQL_SERVICE_HOST 在这里写的是 127.0.0.1，因为它要访问宿主机上的 MySQL 容器。如果你使用的是 Docker Desktop for Windows，这个地址通常没问题，因为容器可以直接访问宿主机的端口映射。但如果你在 Linux 服务器上运行，并且 MySQL 也是 Docker 容器，请确认端口映射已经对宿主机开放，必要时把 127.0.0.1 替换成宿主机内网 IP。
MYSQL_SERVICE_DB_PARAM 是连接串参数，其中 allowPublicKeyRetrieval=true 用来解决 MySQL8.0 caching_sha2_password 认证时可能出现的 Public Key Retrieval 报错，serverTimezone=Asia/Shanghai 用来避免时区问题。
启动后再次查看日志，看到 Nacos started successfully，并且控制台可以正常访问，说明 MySQL 持久化已经生效。
4.5 ECS 上装了 Nacos 一直连不上 MySQL，排查顺序是这样
很多人在云服务器上部署时遇到的报错是“Nacos 访问 MySQL 失败”，但本地同样的命令却正常，问题通常出在四个环节。
第一，MySQL 容器端口是否映射。执行 docker ps 看 3306 端口是否在宿主机监听，没映射就把容器删了重新加 -p 3306:3306。
第二，防火墙和安全组是否放行。云服务器 ECS 需要同时在系统防火墙和云平台安全组中放行 3306（或你自己改的端口），缺一个都会连接失败。检查安全组时要注意，很多云平台的规则是区分内网和公网 IP 的。
第三，账号允许来源。如果 Nacos 在另一个 ECS 或另一个容器中，MySQL 用户必须是 'nacos'@'%' 或 'nacos'@'对应网段'，否则会被拒绝。可以通过 SELECT user, host FROM mysql.user; 查看用户权限范围。
第四，Nacos 启动日志中指向的 MySQL 地址是否可达。进入 Nacos 容器内部去尝试连接 MySQL，是最直接的验证手段：
bash复制docker exec -it nacos-server bash
telnet 宿主机IP 3306
如果 telnet 不通，说明网络链路问题；如果通但 Nacos 日志仍然报错，再去检查用户名密码和数据库名拼写。
5. namespace 一直为 null，往往是没分清“命名空间ID”和“命名空间名”
5.1 namespace 的隔离逻辑：它是租户，不是环境名
先随手点开 Nacos 控制台左侧导航，找到“命名空间”，默认只有一个 public。新建一个命名空间时，页面会让你填命名空间名称、描述，实际上系统还会自动生成一个全局唯一的命名空间 ID。这个 ID 才是客户端在接入 Nacos 时必须填写的关键值。
很多项目里，团队会把命名空间叫做 dev、test、prod，然后客户端配置里也顺手写成 dev。结果服务启动后，控制台里看到服务还是落在 public 命名空间，或者配置始终加载不到，有的人会怀疑 Nacos 坏了。实际上 Nacos 的 namespace 概念更接近租户隔离，ID 是唯一标识，名称只是给人看的。客户端配置中必须使用命名空间 ID，控制台创建时如果选择“自动生成”，那一串 UUID 就是 ID；如果你想要 dev 这种可读的 ID，在创建时可以直接把命名空间 ID 改成 dev。
5.2 客户端填写 namespace 的正确姿势
Spring Cloud 项目接入 Nacos 时，如果使用 spring.cloud.nacos.discovery.namespace 和 spring.cloud.nacos.config.namespace，两个 namespace 要分别配置，它们可以相同，也可以不同。示例：
yaml复制spring:
application:
name: user-service
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: dev
config:
server-addr: 127.0.0.1:8848
namespace: dev
file-extension: yaml
这里如果 Nacos 控制台中的命名空间 ID 就是 dev，那变量填 dev 没问题。但如果你创建时只填了名称叫“开发环境”，系统分配了 UUID，那变量就必须填 UUID。如果配置了错误的命名空间，控制台的“服务列表”里看不到配置的服务，配置中心也拉取不到任何配置，因为它就像一个错位钥匙。
5.3 本地开发时如何优雅地隔离多个项目配置
我在本地开发时经常需要同时跑多个项目，有的项目连接测试环境 Nacos，有的连接本地 Nacos，这时候命名空间帮我避免了大量“改配置改错”的问题。我会在同一个 Nacos 中创建多个命名空间，比如 local、my-test、my-prod，然后通过 Spring Boot 的 profile 来动态切换。
yaml复制spring:
profiles:
active: @profile.active@
构建时使用 -Dprofile.active=local，最终应用加载的 namespace 就是 local。这样本地提交代码不会影响其他同事，测试环境的配置也互相隔离。如果你在控制台看到 namespace 为 null，那八成是用了默认 public，客户端配置里没有显式指定，或者是上面说的 ID 与名称混淆问题。
6. 我的报错排查实录：从日志倒推原因
6.1 Nacos “IPv4 识别不到”，注册地址变成容器内网或 IPv6
容器方式运行 Nacos 后会引入一个特殊问题：Nacos 启动时需要判断当前主机的 IP，作为服务注册到集群或对外提供地址。在容器里，它默认拿到的往往是容器自身的 IP，比如 172.17.0.2，这个地址只存在于 Docker 内网，其他机器无法访问。另一个常见情况是运行环境优先解析出 IPv6 地址，但 RPC 调用通常走 IPv4，导致客户端无法连接。
解决办法是给 Nacos 容器显式指定一个宿主机可达的 IP。在 docker run 时加入：
bash复制-e NACOS_SERVER_IP=192.168.1.100
这里的 192.168.1.100 要改成宿主机在局域网中的实际 IP。如果服务注册发现只在本机做演示，使用 127.0.0.1 也行，但一旦涉及到另一台机器上的消费者，就必须改成客户端能访问到的地址。设定这个变量后，注册到 Nacos 的服务地址会变成固定的宿主机 IP，不再被容器的网络环境干扰。
如果项目确实跑在 IPv6-only 的环境中，可以用 NACOS_SERVER_IP 填入 IPv6 地址，并确保网络路由和安全组放行对应端口。大多数情况下，我还是会优先把地址固定为 IPv4，维护成本低得多。
6.2 端口占用和 9848 没有放行，客户端注册不上的隐藏原因
Nacos 启动本身如果端口被占用，日志会直接报 Address already in use，这个一般不会看漏。更隐蔽的是容器启动正常，控制台也能打开，但客户端就是注册不上去。原因多半是 8848 以外的端口没有放行。
Nacos 2.x 的客户端行为是这样的：先通过 HTTP 端口 8848 做能力协商，然后建立 gRPC 长连接，地址是 8848 加 1000 的偏移，也就是 9848。在云服务器上，安全组如果只放行 8848，客户端注册的第一次请求可能侥幸成功，但随后的心跳检测、配置监听都会失败。排查时可以在客户端机器上尝试连接 9848：
bash复制telnet 服务器IP 9848
不通，就去安全组和防火墙放行 9848、9849。很多 docker 启动安装 nacos 后遇到“客户端心跳超时”“服务下线不正常”的问题，最后都是这个原因。
6.3 数据库连接问题的日志分析与处理链路
如果 Nacos 切到 MySQL 模式后启动失败，需要看日志中的关键异常。最常出现的几类：
Communications link failure：网络层不通，检查 MySQL 容器是否运行、端口映射是否正常、防火墙是否放行。Access denied for user：账号密码错误或账号 host 权限不足，在 MySQL 中执行GRANT授权。Unknown database 'nacos_config'：数据库没有创建，或者名字拼写不一致。Table 'nacos_config.config_info' doesn't exist：初始化脚本没有导入。
拿到日志后，先从网络层往应用层查，不要一上来就改 Nacos 配置。一个有效的做法是先用 MySQL 客户端在宿主机上测试连接，如果宿主机能连而容器连不上，再检查容器间网络或 MYSQL_SERVICE_HOST 的设置。ECS 场景还需要额外确认安全组，因为不同云平台对端口放行的命名入口不一样，规则检查经常被忽略。
6.4 集群模式与 IPv6 地址的边界问题
如果你尝试搭 Nacos 集群并使用了 IPv6 地址，或者宿主机本身有 IPv6 而项目并不想用，日志可能出现识别到多个地址、节点间注册失败的情况。Nacos 在有多个网卡时，地址探测结果可能不符合预期。
我个人的建议是：无论单机还是集群，稳定优先，显式指定 NACOS_SERVER_IP。如果一定要走 IPv6，则保证所有节点、客户端、数据库都能通过 IPv6 互通，并且把 8848/9848/9849 端口都放行。集群部署时，每个 Nacos 节点的 NACOS_SERVER_IP 必须是别的节点也能访问到的地址，不能用 127.0.0.1。先解决网络可达性，再看 Nacos 层配置，顺序不能反。
7. 把服务接进来：Spring Cloud、配置中心热更新、Dubbo
7.1 Spring Cloud 项目注册到 Nacos，先解决依赖版本问题
Spring Cloud Alibaba 项目中，引入服务发现组件的依赖如下：
xml复制<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
这里我不写死具体版本，因为 Spring Cloud Alibaba 的版本必须和 Spring Boot、Spring Cloud 版本匹配。很多人看到应用启动报错或者 bean 找不到，本质都是版本错位。最简单的做法是使用 BOM 统一管理：
xml复制<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>对应Spring Cloud版本</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
版本号以官方版本说明页为准，不要从网上随便复制一个日期版本。启动一个示例服务后，到 Nacos 控制台“服务管理 -> 服务列表”中能看到服务名和实例 IP，注册就成功了。
7.2 配置中心的 dataId 规则和热更新
接入配置中心需要单独引入依赖 `spring-cloud-starter