启动nacos单机服务：下载官方zip包，解压后linux/macos执行sh startup.sh -m standalone，windows执行startup.cmd -m standalone，访问http://localhost:8848/nacos，默认账号密码均为nacos。
怎么启动一个可用的 Nacos 服务（单机模式）
直接跑起来比配集群快得多，开发和测试阶段够用。Nacos 官方包自带内嵌数据库，不用额外装 MySQL 就能跑通注册中心 + 配置中心。
常见错误现象：java.lang.IllegalStateException: Unable to start web server，大概率是端口被占或 JDK 版本不匹配（Nacos 2.x 要求 JDK 8+，但某些旧版 macOS 自带 JDK 11 可能触发 SSL 初始化失败）。
- 下载地址认准官网：https://github.com/alibaba/nacos/releases，选
nacos-server-x.x.x.zip（别下 source 包） - 解压后进
bin目录，Linux/macOS 执行sh startup.sh -m standalone；Windows 执行startup.cmd -m standalone - 启动成功后访问
http://localhost:8848/nacos，默认账号密码都是nacos - 如果提示
Unable to find main class，检查bin/startup.sh里JAVA_HOME是否指向了正确的 JDK 路径（尤其在多 JDK 环境下）
Java 项目怎么连上 Nacos（Spring Boot + Spring Cloud Alibaba）
不是加个依赖就能自动注册，版本对不上会静默失败——比如用 Spring Boot 3.x 却配了 Spring Cloud Alibaba 2021.x，服务根本不会出现在 Nacos 控制台。
使用场景：你写了个 @SpringBootApplication 服务，想让它被其他服务发现，也想从 Nacos 拉配置。
立即学习“Java免费学习笔记（深入）”；
- 确认 Spring Boot 和 Spring Cloud Alibaba 的版本兼容性（查 https://github.com/alibaba/spring-cloud-alibaba/wiki/%E7%89%88%E6%9C%AC%E9%80%89%E5%9E%8B），例如 Spring Boot 2.7.x 对应
spring-cloud-alibaba-dependencies:2021.0.5.0 - 加两个关键依赖：
spring-cloud-starter-alibaba-nacos-discovery（服务发现）、spring-cloud-starter-alibaba-nacos-config（配置管理） -
application.yml里必须写清楚：spring.cloud.nacos.discovery.server-addr: localhost:8848和spring.cloud.nacos.config.server-addr: localhost:8848，少一个就只生效一半 - 启动类上加
@EnableDiscoveryClient（Spring Boot 2.2+ 其实可省，但加上更稳）
Nacos 配置怎么加载才不踩坑（dataId、group、namespace）
配置加载失败往往不是连不上 Nacos，而是 dataId 格式或 namespace 没对上——Spring Boot 默认拼出来的 dataId 是 ${spring.application.name}.${file-extension}，比如服务名是 user-service，就会去找 user-service.yaml。
容易被忽略的点：namespace 不填就是 public，但一旦你在控制台建了自定义命名空间，就必须显式指定 spring.cloud.nacos.config.namespace，否则配置永远加载不到。
- dataId 必须严格匹配，大小写、中横线、扩展名（
.yaml还是.yml）都要一致 - group 默认是
DEFAULT_GROUP，如果你在控制台新建配置时改过 group，就得同步设spring.cloud.nacos.config.group - 配置内容格式要和
file-extension一致：设了spring.cloud.nacos.config.file-extension: yaml，就不能往里填 properties 格式 - 动态刷新需要加
@RefreshScope在使用配置的 Bean 上，只加@Value不行
为什么服务注册上去却找不到（健康检查与元数据常见问题）
Nacos 显示实例数为 1，但调用方始终 No instances available for xxx-service，大概率是健康状态没过，或者元数据不匹配导致路由失败。
性能影响：Nacos 默认每 5 秒发一次心跳，如果网络抖动或 GC 停顿太久，可能被误判下线；另外，ephemeral=false（持久化实例）在故障时反而更难排查。
- 检查服务是否真在 Nacos 实例列表里显示“健康”状态（控制台「服务管理 → 实例列表」看「健康状态」列）
- 确认服务注册时没手动设
spring.cloud.nacos.discovery.ephemeral=false，除非你明确需要持久化注册（比如离线任务调度） - 跨环境调用（如 dev 调 test）要注意 namespace 或 group 隔离，别让 dev 服务去订阅 test 的 group
- 如果用了 OpenFeign，确保
feign.client.config.default.connectTimeout和readTimeout不设得太小，否则在 Nacos 刚启动、实例还没刷全时容易报Load balancer does not have available server
复杂点在于：Nacos 的服务发现是最终一致性模型，注册、心跳、下线都有延迟；而 Spring Cloud Alibaba 的客户端缓存又会叠加一层本地视图。两者叠加，有时候改完配置要等 10–20 秒才真正生效，着急的时候容易反复重启，反而让问题更乱。
