【Java】已解决：feign.FeignException$NotFound异常

屿小夏

发布于 2024-09-10 08:31:58

960

发布于 2024-09-10 08:31:58

文章被收录于专栏：IT杂谈学习

一、分析问题背景

在微服务架构中，Feign是一种用于简化HTTP客户端调用的声明式Web服务客户端。在使用Feign调用其他服务时，开发者可能会遇到feign.FeignException$NotFound异常。该异常通常发生在被调用的服务返回404状态码时，表示请求的资源未找到。

场景：在一个Spring Boot项目中，使用Feign客户端调用另一个微服务的API，但该API返回404错误，导致Feign抛出FeignException$NotFound异常。

示例代码片段：

@FeignClient(name = "userService", url = "http://localhost:8080")
public interface UserClient {

    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
}

@Service
public class UserService {

    @Autowired
    private UserClient userClient;

    public User findUserById(Long id) {
        return userClient.getUserById(id);
    }
}

当我们调用findUserById方法，并传入一个不存在的用户ID时，会抛出feign.FeignException$NotFound异常。

二、可能出错的原因

导致feign.FeignException$NotFound异常的原因主要有以下几点：

资源不存在：请求的资源在被调用的服务中不存在，导致返回404状态码。
URL错误：Feign客户端配置的URL错误，指向了不存在的路径。
参数错误：传递给Feign客户端的参数有误，导致请求路径不正确。

三、错误代码示例

以下是一个可能导致该报错的代码示例，并解释其错误之处：

@FeignClient(name = "userService", url = "http://localhost:8080")
public interface UserClient {

    // 错误的URL路径或参数
    @GetMapping("/user/{id}")  // 正确路径应为"/users/{id}"
    User getUserById(@PathVariable("id") Long id);
}

错误分析：

URL路径错误：定义的@GetMapping路径为/user/{id}，而实际应为/users/{id}，导致请求资源不存在，从而返回404错误。

四、正确代码示例

为了正确解决该报错问题，我们需要确保Feign客户端的URL路径和参数正确。以下是正确的代码示例：

@FeignClient(name = "userService", url = "http://localhost:8080")
public interface UserClient {

    // 正确的URL路径
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
}

@Service
public class UserService {

    @Autowired
    private UserClient userClient;

    public User findUserById(Long id) {
        try {
            return userClient.getUserById(id);
        } catch (FeignException.NotFound e) {
            // 处理404错误，返回null或抛出自定义异常
            return null;
        }
    }
}

通过上述代码，我们确保了Feign客户端的URL路径正确，并在服务方法中捕获FeignException.NotFound异常，以便进行相应的错误处理。