java后端开发中，Nacos是阿里巴巴开源的一款集服务发现、配置管理和服务管理于一体的中间件，能够有效解决分布式系统中配置分散、服务调用地址硬编码的问题，本文将从环境准备到功能实现逐步讲解其使用方法。
Nacos环境准备
首先需要部署Nacos服务端，我们可以从Nacos的官方仓库下载对应版本的压缩包，解压后进入bin目录，根据操作系统执行启动命令。Linux或macOS系统执行sh startup.sh -m standalone，Windows系统执行startup.cmd -m standalone，启动后访问默认地址127.0.0.1:8848/nacos，默认账号密码都是nacos，即可进入Nacos控制台。
集成Nacos作为配置中心
添加依赖
在java后端项目的pom.xml中添加Nacos配置中心相关依赖，如果是Spring Boot项目，可使用如下依赖：
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
<version>2021.0.5.0</version>
</dependency>
配置Nacos连接信息
在项目的resources目录下创建bootstrap.yml文件，配置Nacos服务端的地址、命名空间、配置分组等信息，bootstrap.yml的加载优先级高于application.yml，能够保证配置中心的信息先被加载：
spring:
application:
name: user-service
cloud:
nacos:
config:
server-addr: 127.0.0.1:8848
namespace: dev
group: DEFAULT_GROUP
file-extension: yaml
在Nacos控制台添加配置
进入Nacos控制台的配置管理页面，点击新建配置，Data ID的格式为${spring.application.name}.${file-extension}，这里对应就是user-service.yaml，分组选择DEFAULT_GROUP，配置格式选择YAML，在配置内容中写入需要管理的配置，比如：
user: max-age: 18 default-name: test
代码中读取配置
在java代码中可以通过@Value注解或者@ConfigurationProperties注解读取配置中心的配置，如果需要支持配置动态更新，需要添加@RefreshScope注解：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RefreshScope
@RestController
public class UserController {
@Value("${user.max-age}")
private Integer maxAge;
@Value("${user.default-name}")
private String defaultName;
@GetMapping("/user/config")
public String getConfig() {
return "maxAge:" + maxAge + ",defaultName:" + defaultName;
}
}
修改Nacos控制台中的配置后，不需要重启项目，接口返回的内容会自动更新。
集成Nacos作为服务发现
添加依赖
同样在pom.xml中添加Nacos服务发现的依赖：
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
<version>2021.0.5.0</version>
</dependency>
配置服务发现信息
在application.yml中添加Nacos服务发现的配置：
spring:
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: dev
group: DEFAULT_GROUP
开启服务注册
在Spring Boot的启动类上添加@EnableDiscoveryClient注解，开启服务发现功能，项目启动后会自动将当前服务注册到Nacos：
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
@EnableDiscoveryClient
@SpringBootApplication
public class UserServiceApplication {
public static void main(String[] args) {
SpringApplication.run(UserServiceApplication.class, args);
}
}
服务调用示例
如果需要在当前服务中调用其他注册到Nacos的服务，可以使用RestTemplate或者OpenFeign，这里以RestTemplate为例，先创建RestTemplate的Bean并添加@LoadBalanced注解实现负载均衡：
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestTemplate;
@Configuration
public class RestTemplateConfig {
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
return new RestTemplate();
}
}
然后在Controller中调用其他服务，服务名就是其他项目的spring.application.name配置的值：
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;
import javax.annotation.Resource;
@RestController
public class OrderController {
@Resource
private RestTemplate restTemplate;
@GetMapping("/order/call-user")
public String callUser() {
// user-service是其他注册到Nacos的服务名
return restTemplate.getForObject("http://user-service/user/config", String.class);
}
}
启动多个user-service实例后，调用接口会自动实现负载均衡，将请求分发到不同的实例上。
常见问题说明
- bootstrap.yml不生效：需要检查是否添加了spring-cloud-starter-bootstrap依赖，Spring Cloud 2020版本之后需要单独引入该依赖才能加载bootstrap.yml。
- 配置动态更新不生效：需要确认是否在Controller或者对应的Bean上添加了@RefreshScope注解，并且Nacos中的配置Data ID、分组和项目中的配置保持一致。
- 服务注册失败：检查Nacos服务端的地址、命名空间、分组是否和项目配置一致，同时确认项目依赖版本和Spring Boot、Spring Cloud版本兼容。