跨类调用方法时DiscoveryClient出现java.lang.NullPointerException异常

我之前也碰到过一模一样的坑，咱们先把问题理清楚，再一步步排查：

问题重现 #

直接访问接口/getArticle/{articleId}能正常返回JSON，说明articlemicroservice确实已经注册，而且接口逻辑没问题，但方法内部调用discoveryClient.getInstances("articlemicroservice")返回null，导致空指针异常。关键代码如下：

@RequestMapping("/getArticle/{articleId}")
public String getArticle(@PathVariable("articleId") Integer articleId) {
    // {"articleId":47,"name":"test","price":5.0}
    List<ServiceInstance> instances = discoveryClient.getInstances("articlemicroservice"); // 这里返回null
    ServiceInstance serviceInstance = instances.get(0);
    // ... 后续业务逻辑
}

常见解决思路 #

1. 先检查DiscoveryClient的注入是否正确

绝对不能手动new DiscoveryClient()！必须通过Spring容器注入，否则它不会和注册中心建立连接：

// 推荐构造函数注入（避免空注入）
private final DiscoveryClient discoveryClient;

public YourController(DiscoveryClient discoveryClient) {
    this.discoveryClient = discoveryClient;
}

// 或者Autowired注入（也可以，但构造函数更安全）
// @Autowired
// private DiscoveryClient discoveryClient;

2. 核对服务名称的大小写（致命坑！）

注册中心的服务名称是大小写敏感的！比如你注册的服务名是ArticleMicroservice，但代码里传的是articlemicroservice，就会返回null。

• 去注册中心控制台（比如Eureka的http://localhost:8761）确认服务的准确名称，确保和代码里的参数完全一致。

3. 确认服务实例处于UP状态

就算服务注册了，如果实例状态是DOWN或者OUT_OF_SERVICE，DiscoveryClient也不会返回它。去注册中心控制台看一下articlemicroservice的实例状态是否正常。

4. 延迟加载/服务列表未同步

如果你的服务刚启动就调用这个接口，可能DiscoveryClient还没完成服务列表的拉取：

• 测试环境可以加个短暂延迟（比如Thread.sleep(2000)）验证；
• 生产环境可以调整注册中心的配置，缩短服务列表刷新间隔，或者用@Lazy注解延迟注入DiscoveryClient：

  @Autowired
  @Lazy
  private DiscoveryClient discoveryClient;
  

5. 检查注册中心配置是否正确

确保你的服务已经正确配置了注册中心地址，比如：

• Eureka：eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
• Nacos：spring.cloud.nacos.discovery.server-addr=localhost:8848
  如果配置错误，DiscoveryClient根本连不上注册中心，自然拿不到实例。

先从注入方式和服务名称这两点排查，这是最常见的原因！

内容的提问来源于stack exchange，提问作者elp