使用Feign Client实现美团外卖霸王餐接口的声明式调用与错误重试机制

使用Feign Client实现美团外卖霸王餐接口的声明式调用与错误重试机制

在微服务架构中，服务间通信是核心环节之一。Spring Cloud OpenFeign 作为声明式 HTTP 客户端，极大简化了远程调用的代码复杂度。本文将围绕如何使用 Feign Client 调用美团外卖“霸王餐”活动接口，并集成错误重试机制，提供完整的 Java 实现方案。

1. 引入依赖与基础配置

首先，在 pom.xml 中引入必要的依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-okhttp</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.retry</groupId>
    <artifactId>spring-retry</artifactId>
</dependency>

在启动类上启用 Feign 和重试支持：

@SpringBootApplication
@EnableFeignClients(basePackages = "baodanbao.com.cn.feign")
@EnableRetry
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

2. 定义 Feign Client 接口

创建 Feign Client 接口，用于调用美团外卖的霸王餐活动接口：

package baodanbao.com.cn.feign;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import baodanbao.com.cn.dto.MeituanFreeMealResponse;

@FeignClient(
    name = "meituan-free-meal",
    url = "${meituan.api.url:https://open-api.meituan.com}",
    configuration = MeituanFeignConfig.class
)
public interface MeituanFreeMealFeignClient {

    @GetMapping("/v1/free-meal/query")
    MeituanFreeMealResponse queryFreeMeal(
        @RequestParam("app_key") String appKey,
        @RequestParam("timestamp") Long timestamp,
        @RequestParam("sign") String sign,
        @RequestParam("city_id") Integer cityId
    );
}

3. 自定义 Feign 配置与错误解码器

为处理美团返回的非标准 HTTP 状态码（如业务错误仍返回 200），需自定义 ErrorDecoder：

package baodanbao.com.cn.feign;

import feign.Response;
import feign.codec.ErrorDecoder;
import com.fasterxml.jackson.databind.ObjectMapper;
import baodanbao.com.cn.exception.MeituanApiException;

public class MeituanErrorDecoder implements ErrorDecoder {

    private final ObjectMapper objectMapper = new ObjectMapper();

    @Override
    public Exception decode(String methodKey, Response response) {
        try {
            if (response.body() != null) {
                String body = new String(response.body().asInputStream().readAllBytes());
                // 假设美团返回 JSON 格式，包含 code 字段
                var node = objectMapper.readTree(body);
                int code = node.get("code").asInt();
                if (code != 0) {
                    String msg = node.has("msg") ? node.get("msg").asText() : "未知错误";
                    return new MeituanApiException("美团接口业务错误: " + msg + " (code=" + code + ")");
                }
            }
        } catch (Exception e) {
            return new RuntimeException("解析美团响应失败", e);
        }
        return new FeignException("Feign 调用失败", response);
    }
}

对应的 Feign 配置类：

package baodanbao.com.cn.feign;

import feign.codec.ErrorDecoder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MeituanFeignConfig {

    @Bean
    public ErrorDecoder errorDecoder() {
        return new MeituanErrorDecoder();
    }
}

4. 集成 Spring Retry 实现重试机制

在 Feign Client 方法上添加 @Retryable 注解，指定重试策略：

package baodanbao.com.cn.service;

import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Retryable;
import org.springframework.stereotype.Service;
import baodanbao.com.cn.feign.MeituanFreeMealFeignClient;
import baodanbao.com.cn.dto.MeituanFreeMealResponse;

@Service
public class FreeMealService {

    private final MeituanFreeMealFeignClient feignClient;

    public FreeMealService(MeituanFreeMealFeignClient feignClient) {
        this.feignClient = feignClient;
    }

    @Retryable(
        value = {MeituanApiException.class, FeignException.class},
        maxAttempts = 3,
        backoff = @Backoff(delay = 1000, multiplier = 2)
    )
    public MeituanFreeMealResponse fetchFreeMealOffers(Integer cityId) {
        String appKey = "your_app_key";
        long timestamp = System.currentTimeMillis() / 1000;
        String sign = generateSign(appKey, timestamp); // 签名逻辑略
        return feignClient.queryFreeMeal(appKey, timestamp, sign, cityId);
    }

    private String generateSign(String appKey, long timestamp) {
        // 实际应使用美团提供的 HMAC-SHA256 签名算法
        return "mock_sign";
    }
}

5. 全局异常处理与日志记录

为避免重试过程中静默失败，建议配合全局异常处理器记录日志：

package baodanbao.com.cn.aspect;

import org.aspectj.lang.annotation.AfterThrowing;
import org.aspectj.lang.annotation.Aspect;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class FeignRetryLoggingAspect {

    private static final Logger log = LoggerFactory.getLogger(FeignRetryLoggingAspect.class);

    @AfterThrowing(
        pointcut = "@annotation(org.springframework.retry.annotation.Retryable)",
        throwing = "ex"
    )
    public void logRetryAttempt(Exception ex) {
        log.warn("Feign 调用重试中，当前异常: {}", ex.getMessage(), ex);
    }
}

6. 配置文件优化

在 application.yml 中配置连接超时与读取超时：

feign:
  client:
    config:
      meituan-free-meal:
        connectTimeout: 3000
        readTimeout: 5000
        loggerLevel: full
  okhttp:
    enabled: true

meituan:
  api:
    url: https://open-api.meituan.com

通过上述配置，Feign 将使用 OkHttp 作为底层 HTTP 客户端，提升性能与稳定性。

本文著作权归吃喝不愁app开发者团队，转载请注明出处！