【java报错已解决】feign.FeignException$NotFound异常

引言：

在Java开发的世界里，我们常常会遇到各种各样的报错信息，这些报错就像是路上的绊脚石，阻碍着我们项目的顺利推进。其中，feign.FeignException

NotFound异常的相关问题及解决办法吧。

一、问题描述：

1.1报错示例：

假设我们正在开发一个电商系统，其中有一个订单服务和一个商品服务，订单服务需要通过Feign客户端调用商品服务来获取商品的详细信息。以下是一段可能出现feign.FeignException$NotFound异常的简化代码示例：

首先是订单服务中的Feign客户端接口定义：

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

@FeignClient(name = "product-service", url = "http://localhost:8081")
public interface ProductFeignClient {

    @GetMapping("/products/{productId}")
    String getProductDetails(@PathVariable("productId") Long productId);
}

然后在订单服务的某个业务逻辑方法中调用这个Feign客户端方法：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class OrderService {

    @Autowired
    private ProductFeignClient productFeignClient;

    public String processOrder(Long productId) {
        try {
            return productFeignClient.getProductDetails(productId);
        } catch (feign.FeignException e) {
            e.printStackTrace();
            return "获取商品详情失败";
        }
    }
}

当我们在测试订单服务的processOrder方法时，可能就会遇到feign.FeignException$NotFound异常，控制台会输出类似这样的报错信息：

feign.FeignException$NotFound: [404] during [GET] to [http://localhost:8081/products/123] [ProductFeignClient#getProductDetails(Long)]

这里假设我们传入的productId为123，从报错信息可以看出，在向http://localhost:8081/products/123发送GET请求时，得到了404的状态码，也就是资源未找到的错误。

1.2报错分析：

从上述报错示例来看，出现feign.FeignException$NotFound异常，也就是404错误，主要可能有以下几个原因：

（1）服务地址或端口错误：

在我们定义的Feign客户端@FeignClient(name = "product-service", url = "http://localhost:8081")中，指定的url可能不正确。也许商品服务实际运行的端口不是8081，或者服务的主机地址已经发生了变化，导致Feign客户端无法正确找到对应的服务端点来发送请求。

（2）请求路径错误：

在Feign客户端接口中定义的@GetMapping("/products/{productId}")这个请求路径，可能与商品服务中实际接收该请求的路径不一致。有可能是在商品服务端对请求路径进行了修改，而我们的Feign客户端没有相应更新，这样当Feign客户端按照旧的路径发送请求时，商品服务就无法正确识别并处理，从而返回404错误。

（3）服务未启动或不可用：

很有可能商品服务本身并没有成功启动，或者在运行过程中出现了故障导致不可用。当Feign客户端尝试向其发送请求时，自然就无法找到对应的资源，进而抛出404的NotFound异常。

1.3解决思路：

基于上述的报错分析，我们可以有以下大致的解决思路：

（1）检查服务地址和端口：

首先要确认商品服务实际运行的地址和端口，然后与Feign客户端中定义的url进行对比，如果不一致，及时修改Feign客户端中的url配置，使其能够准确指向商品服务所在的位置。

（2）核对请求路径：

仔细检查Feign客户端接口中定义的请求路径与商品服务端实际接收请求的路径是否一致。如果商品服务端的路径发生了变化，需要在Feign客户端中同步更新相应的请求路径定义。

（3）检查服务状态：

确保商品服务已经成功启动并且处于正常运行状态。可以通过查看商品服务的控制台输出、日志文件等方式来排查是否存在启动失败或者运行过程中的故障问题。如果发现服务有问题，及时修复使其能够正常响应Feign客户端的请求。

二、解决方法：

2.1方法一：检查并修正服务地址和端口

步骤一：确认商品服务运行地址和端口

通过查看商品服务的启动配置文件（比如在Spring Boot项目中可能是application.properties或application.yml文件），找到其中配置的服务运行的主机地址和端口号。例如，在application.properties文件中可能有如下配置：

server.port=8082
server.address=localhost

这就表明商品服务实际运行在localhost主机的8082端口。

步骤二：修改Feign客户端配置

根据确认的商品服务运行地址和端口，修改Feign客户端中的url配置。在之前的示例中，将@FeignClient(name = "product-service", url = "http://localhost:8081")修改为@FeignClient(name = "product-service", url = "http://localhost:8082")。

这样，Feign客户端就能准确地向商品服务所在的正确位置发送请求，避免因地址和端口错误导致的404 NotFound异常。

2.2方法二：核对并更新请求路径

步骤一：查看商品服务端请求路径定义

在商品服务的相关控制器类中，找到接收Feign客户端请求的对应方法，查看其定义的请求路径。比如在一个Spring Boot的商品服务项目中，可能有如下控制器类：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ProductController {

    @GetMapping("/product-info/{productId}")
    public String getProductInfo(@PathVariable("productId") Long productId) {
        // 这里是具体的业务逻辑处理，比如从数据库获取商品信息等
        return "商品详情";
    }
}

可以看到，商品服务端实际接收请求的路径是/product-info/{productId}，与我们之前Feign客户端定义的/products/{productId}不一致。

步骤二：更新Feign客户端请求路径

根据商品服务端的请求路径定义，更新Feign客户端接口中的请求路径。将@GetMapping("/products/{productId}")修改为@GetMapping("/product-info/{productId}")。

经过这样的更新，Feign客户端发送的请求路径就能与商品服务端接收的路径匹配，从而减少因路径不一致导致的404异常。

2.3方法三：检查服务状态并修复

步骤一：查看商品服务控制台输出

启动商品服务后，仔细查看其控制台输出，看是否有任何启动失败的提示信息。比如可能会出现类似“无法连接数据库”、“端口被占用”等错误提示，这些提示会明确指出服务启动失败的原因。

步骤二：排查并修复故障

如果发现了启动失败的原因，就针对具体问题进行排查和修复。例如，如果是“无法连接数据库”的问题，就检查数据库的连接配置是否正确，包括数据库的地址、用户名、密码等是否准确；如果是“端口被占用”的问题，就更换商品服务的运行端口，或者找到占用该端口的程序并停止它。

步骤三：确认服务正常运行

在修复了可能存在的故障后，再次启动商品服务，确保其能够正常运行。可以通过在浏览器中访问商品服务的一些测试端点（如果有设置的话），或者查看服务的日志文件，看是否有正常的业务处理记录，以此来确认服务已经处于正常运行状态。

当商品服务正常运行后，Feign客户端再向其发送请求时，就不太可能因为服务不可用而收到404 NotFound异常了。

2.4方法四：添加日志记录详细排查

步骤一：在Feign客户端添加日志配置

在项目的配置文件（如application.properties或application.yml）中添加Feign客户端的日志配置。以下是在application.properties文件中的示例配置：

feign.client.config.product-service.loggerLevel=FULL

这里的product-service是我们在Feign客户端中定义的服务名称，通过设置loggerLevel为FULL，可以让Feign客户端在发送请求时记录详细的日志信息，包括请求的头部、请求体、响应的头部、响应体等。

步骤二：分析日志信息排查问题

当Feign客户端再次发送请求并出现404 NotFound异常时，查看生成的详细日志信息。通过分析日志，可以更清楚地看到请求的具体情况，比如请求是否真正按照我们预期的方式发送出去了，响应的具体内容是什么等等。

例如，从日志中可能会发现请求的头部信息缺失了某些必要的字段，或者响应的状态码虽然是404，但响应体中可能包含了一些更详细的提示信息（如“该商品已下架”等），这些信息可以帮助我们进一步准确地定位问题所在，从而采取更有针对性的解决措施。

三、其他解决方法：

（1）使用服务发现机制：

如果项目中使用了服务发现组件（如Eureka、Consul等），可以将Feign客户端配置为通过服务发现机制来查找商品服务，而不是直接指定固定的地址和端口。这样，即使商品服务的地址或端口发生了变化，只要服务在服务发现组件中正常注册，Feign客户端就能自动找到它并发送请求。

例如，在Spring Cloud项目中，将Feign客户端的@FeignClient注解修改如下：

@FeignClient(name = "product-service", discoveryClient = EurekaClient.class)

这里假设使用的是Eureka服务发现组件，通过指定discoveryClient为EurekaClient.class，Feign客户端就会通过Eureka来查找商品服务。

（2）检查网络连接：

有时候，404 NotFound异常可能并不是因为代码层面的问题，而是网络连接出现了故障。可以检查订单服务所在机器与商品服务所在机器之间的网络连接是否正常。可以通过ping命令来测试两台机器之间的网络连通性，例如在订单服务所在机器上执行ping localhost（如果商品服务在本地运行）或ping [商品服务所在主机地址]（如果商品服务在远程运行）。

如果发现网络连接不通，就需要排查网络故障，可能涉及到检查网络设备（如路由器、交换机等）、网络配置（如IP地址、子网掩码等）等方面的问题。

（3）验证请求参数：

在Feign客户端发送请求时，传入的请求参数（如上述示例中的productId）也可能会影响请求的结果。有可能是因为传入的请求参数不符合商品服务端的要求，导致商品服务无法正确处理请求并返回404错误。

可以在商品服务端的接收请求方法中添加日志记录，记录下接收到的请求参数，然后对比Feign客户端传入的请求参数，看是否存在差异。如果发现差异，就需要调整Feign客户端传入的请求参数，使其符合商品服务端的要求。

四、总结：

在本文中，我们详细探讨了在Java开发中遇到feign.FeignException$NotFound异常的相关问题。首先通过具体的报错示例展示了该异常在实际代码中的表现形式，接着从服务地址和端口错误、请求路径错误、服务未启动或不可用等方面分析了产生该异常的原因。

针对这些原因，我们提出了多种解决方法，包括检查并修正服务地址和端口、核对并更新请求路径、检查服务状态并修复、添加日志记录详细排查等，还介绍了一些其他的解决方法如使用服务发现机制、检查网络连接、验证请求参数等。

下次再遇到feign.FeignException$NotFound异常时，首先不要慌张，要冷静地按照以下步骤进行排查：

1. 查看报错信息中的请求地址和路径，与自己预期的以及服务端实际的情况进行对比，判断是否存在地址或路径错误的情况，如果有，及时修正。
2. 检查服务是否启动且正常运行，可以通过查看服务的控制台输出、日志文件等方式来确认，若存在问题，尽快修复。
3. 添加日志记录（如果之前没有设置的话），以便更详细地了解请求和响应的情况，通过分析日志进一步排查问题所在。
4. 考虑是否使用了服务发现机制，如果没有，可以尝试采用这种方式来提高服务查找的灵活性和准确性。
5. 检查网络连接是否正常，尤其是在涉及到不同机器之间的服务调用时，确保网络畅通。
6. 验证请求参数是否符合服务端的要求，避免因参数问题导致服务无法正确处理请求。

通过以上这些步骤的有序排查，相信能够更高效地解决feign.FeignException$NotFound异常，让我们的Java开发项目能够更加顺利地进行。