开发中的接口调试难题？Pretender-Proxy 来帮你解决！

开发中的痛点

在微服务开发中，你是否遇到过这样的场景？

• 🔴 下游服务还没开发完，但你需要调试自己的接口
• 🔴 第三方API不稳定，经常超时或返回错误
• 🔴 测试环境不可用，但本地开发需要完整的调用链
• 🔴 Mock数据管理混乱，每次都要手动修改代码

这些问题的核心在于：如何在依赖服务不可用时，继续高效地进行开发？

传统解决方案的局限性

方案1：硬编码Mock

// 在代码中硬编码返回数据
if (isDevMode) {
    return mockData;
}

问题：代码污染、难以维护、无法动态调整

方案2：使用Mock框架

@MockBean
private ExternalService externalService;

问题：只能Mock自己的服务，无法Mock外部API

方案3：手动配置代理

# 手动设置系统代理
export http_proxy=http://127.0.0.1:8080

问题：配置复杂、功能有限、难以管理

发现解决方案：Pretender-Proxy

在寻找更好的解决方案时，我发现了 Pretender-Proxy 这个工具。它完美解决了上述所有问题！

🎯 核心优势

1. 零代码侵入 - 不需要修改任何业务代码
2. 动态配置 - 支持热加载，修改配置无需重启
3. 智能转发 - 不匹配的请求自动转发到真实服务器
4. Docker化部署 - 一键启动，环境一致

实际应用场景

场景1：下游服务开发中

问题：用户服务还在开发，但订单服务需要调用用户信息

传统做法：

// 硬编码用户信息
User user = new User();
user.setId(1L);
user.setName("测试用户");

使用Pretender-Proxy：

# mock_config.yaml
mocks:
  - url: ^http://user-service/api/users/.*$
    method: GET
    response:
      code: 200
      data:
        id: 1
        name: "测试用户"
        email: "test@example.com"

场景2：第三方API不稳定

问题：支付接口经常超时，影响开发效率

解决方案：

mocks:
  - url: ^https://api.payment.com/.*$
    method: POST
    response:
      code: 200
      message: "支付成功"
      orderId: "PAY123456"

场景3：多环境配置

问题：开发、测试、预发布环境需要不同的Mock数据

解决方案：

# 开发环境
docker run -d -p 8888:8888 -v ./dev-config:/app/config pretender-proxy

# 测试环境  
docker run -d -p 8889:8888 -v ./test-config:/app/config pretender-proxy

# 预发布环境
docker run -d -p 8890:8888 -v ./staging-config:/app/config pretender-proxy

快速上手

1. 一键启动

# 拉取镜像
docker pull jsonstiananan/pretender-proxy:latest

# 创建配置目录
mkdir mockConfig

# 启动服务
docker run -d -p 8888:8888 -v ./mockConfig:/app/config jsonstiananan/pretender-proxy:latest

2. 配置代理

浏览器设置：

• Chrome: 设置 → 高级 → 系统 → 打开代理设置 → 手动设置代理
• 地址：127.0.0.1，端口：8888

Java应用设置：

// Gradle bootRun
bootRun {
    jvmArgs = [
        "-Dhttp.proxyHost=localhost",
        "-Dhttp.proxyPort=8888"
    ]
}

3. 编写Mock规则

创建 mockConfig/mock_config.yaml：

mocks:
  # 用户服务Mock
  - url: ^http://user-service/api/users/.*$
    method: GET
    response:
      code: 200
      data:
        id: 1
        name: "张三"
        email: "zhangsan@example.com"
  
  # 支付服务Mock
  - url: ^https://api.payment.com/pay$
    method: POST
    response:
      code: 200
      message: "支付成功"
      orderId: "PAY123456"
  
  # 商品服务Mock
  - url: ^http://product-service/api/products/.*$
    method: GET
    response:
      code: 200
      data:
        id: 1
        name: "iPhone 15"
        price: 5999

4. 测试验证

# 测试用户服务
curl -x http://127.0.0.1:8888 http://user-service/api/users/1

# 测试支付服务
curl -x http://127.0.0.1:8888 -X POST https://api.payment.com/pay

# 测试商品服务
curl -x http://127.0.0.1:8888 http://product-service/api/products/1

高级技巧

1. 动态Mock数据

mocks:
  - url: ^http://api.example.com/users/(\d+)$
    method: GET
    response:
      code: 200
      data:
        id: "${1}"  # 使用正则捕获组
        name: "用户${1}"
        createTime: "2024-01-01 00:00:00"

2. 条件Mock

mocks:
  - url: ^http://api.example.com/orders$
    method: POST
    headers:
      Authorization: "Bearer.*"  # 需要认证
    response:
      code: 200
      message: "订单创建成功"

3. 错误场景模拟

mocks:
  - url: ^http://api.example.com/timeout$
    method: GET
    response:
      code: 408
      message: "请求超时"
      delay: 5000  # 延迟5秒

最佳实践

1. 配置管理策略

按功能模块组织：

mockConfig/
├── user-service.yaml
├── payment-service.yaml
├── product-service.yaml
└── common.yaml

按环境组织：

configs/
├── dev/
├── test/
└── staging/

2. 团队协作

• 📝 文档化Mock规则：为每个Mock规则添加注释说明
• 🔄 版本控制：将配置文件纳入Git管理
• 👥 团队共享：建立Mock规则库，团队成员共享使用

3. 性能优化

• 🎯 精确匹配：使用具体的URL模式，避免过于宽泛的正则
• 🧹 定期清理：删除不再使用的Mock规则
• 📊 监控使用：关注Mock服务的访问日志

常见问题解决

Q1: Mock规则不生效？

检查清单：

• ✅ 正则表达式语法是否正确
• ✅ URL是否完全匹配
• ✅ 配置文件格式是否正确
• ✅ 服务是否正常启动

Q2: 代理设置后无法访问网络？

解决方案：

# 检查代理设置
curl -v -x http://127.0.0.1:8888 http://www.baidu.com

# 临时关闭代理测试
unset http_proxy https_proxy

Q3: Docker容器启动失败？

排查步骤：

# 查看容器日志
docker logs <container_id>

# 检查端口占用
netstat -tlnp | grep 8888

# 重新启动容器
docker restart <container_id>

效果对比

使用前

开发效率：⭐⭐⭐
维护成本：⭐⭐⭐⭐⭐
团队协作：⭐⭐

使用后

开发效率：⭐⭐⭐⭐⭐
维护成本：⭐⭐
团队协作：⭐⭐⭐⭐⭐

总结

Pretender-Proxy 不仅仅是一个工具，更是解决开发痛点的完整解决方案。它让我们的开发过程更加流畅，让团队协作更加高效。

核心价值：

• 🚀 提升开发效率 - 不再被依赖服务阻塞
• 🛠️ 简化配置管理 - 统一的Mock规则管理
• 🔄 支持热更新 - 修改配置无需重启
• 🐳 Docker化部署 - 环境一致，快速启动

如果你还在为接口调试而烦恼，不妨试试这个工具。相信它会成为你开发工具箱中的得力助手！

相关资源：

• 🐳 Docker Hub镜像
• 📚 GitHub项目
• ⚡ 快速开始: docker pull jsonstiananan/pretender-proxy

本文由博客群发一文多发等运营工具平台 OpenWrite 发布