Java微服务环境搭建指南

Java微服务底座应基于Spring Boot 3.x（JDK 17+）与Spring Cloud生态，选用Nacos注册/配置中心、OpenFeign+LoadBalancer通信、Spring Cloud Gateway网关、SkyWalking链路追踪，配合Docker本地开发、Nacos命名空间隔离环境、独立jar部署及Prometheus+Grafana监控，强调轻量、可控、可观测。

Java微服务环境的核心是轻量、可独立部署、服务间解耦，不是堆砌技术，而是围绕Spring Boot + Spring Cloud生态构建一套稳定、可观测、易扩展的底座。重点不在“全”，而在“够用且可控”。

选型：精简务实的技术栈

避免过度设计。推荐组合：

• 基础框架：Spring Boot 3.x（JDK 17+），提供自动配置、内嵌容器、健康检查等开箱能力
• 服务注册与发现：Nacos（单机或集群模式），兼顾配置中心与注册中心，对Java生态友好，启动快、控制台直观
• 服务通信：OpenFeign（声明式HTTP调用）+ LoadBalancer（替代已废弃的Ribbon），配合Spring Cloud LoadBalancer做客户端负载均衡
• API网关：Spring Cloud Gateway（基于WebFlux，非阻塞，适合高并发场景），不建议用Zuul（已停更）
• 链路追踪：Micrometer + Zipkin 或 SkyWalking（后者对Java Agent支持更成熟，无需改代码）

本地开发环境快速就绪

开发者不需要搭全套生产环境，但需模拟关键组件行为：

• 用 Docker 启一个 Nacos 容器：docker run -d -p 8848:8848 --name nacos -e MODE=standalone nacos/nacos-server:v2.3.2
• 在每个 Spring Boot 模块的 application.yml 中配置 Nacos 地址：
  spring.cloud.nacos.discovery.server-addr: localhost:8848
• 启用 Actuator 端点（如 /actuator/health, /actuator/metrics），加依赖：spring-boot-starter-actuator
• 加 @EnableDiscoveryClient 注解，服务启动时自动注册到 Nacos

配置分离与环境隔离

不同环境（dev/test/prod）必须物理隔离配置，避免误操作：

• Nacos 中按 命名空间（namespace） 划分环境，每个 namespace 有唯一 ID，服务通过 spring.profiles.active + spring.cloud.nacos.config.namespace 绑定
• 公共配置（如日志级别、数据库连接池参数）放在 shared-configs；服务独有配置（如支付回调地址）放各自 dataId
• 敏感配置（密码、密钥）不进 Git，用 Nacos 的加密配置（配合 nacos-config-encrypt）或 K8s Secret 注入

最小可用部署结构（非K8s场景）

上线不必一步到位上云原生，先保证核心能力跑通：

• 每服务打成 独立可执行 jar 包（mvn clean package），用 java -jar 启动，指定 profile 和配置中心地址
• Nacos 单节点用于测试，生产至少三节点集群（用 MySQL 持久化注册数据）
• 网关单独部署，所有外部请求走 Gateway，内部服务间调用直连（通过 Nacos 获取实例列表）
• 加一个简单的监控看板：Prometheus 抓取各服务 Actuator 的 /actuator/prometheus，Grafana 展示 JVM 内存、HTTP QPS、服务注册状态

基本上就这些。不复杂但容易忽略的是配置生效时机、服务注册延迟、健康检查路径是否被网关拦截——这些细节比选型更能决定第一天上线顺不顺利。