前言
最近在做 Coupang 跨境 ERP 供应链溯源模块，业务目标很简单：拿到 Coupang 平台商品，反向找到 1688 上游货源，拿到采购价、供应商、起批参数，用于利润核算、备货以及商品刊登。
最开始设想直接翻译韩文标题，拿中文关键词去 1688 搜商品。实际跑批量任务之后发现坑非常多：卖家改写标题、翻译歧义、类目错位，文字搜索召回的错误率居高不下。 于是转向方案：使用 1688 图片搜索 API，拿 Coupang 商品主图做以图搜图，完成货源溯源。本篇为项目落地踩坑实录，记录真实遇到的问题、踩过的雷以及最终的工程处理方案。
业务背景
Coupang 面向韩国市场，商家上架之后商品信息全部韩文化。平台只留存面向买家的销售数据，不会透出国内供应链源头信息。 我们的业务诉求：
- 批量给库内大量 Coupang 商品匹配 1688 源头货源；
- 获取批发价格、规格、供应商信息，用于内部成本测算；
- 建立 Coupang‑itemId 与 1688‑itemId 映射关系，方便后续铺货、补货业务。
理想状态：传入一张商品图，直接返回准确货源。现实项目里远没有这么顺滑。
整体实现流程简述
请求基础信息：
接口名称：1688.item_search_img（1688图片搜索API，taobaoapi2014前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
接口版本：2.0
鉴权方式：AppKey + AppSecret 签名校验（MD5/HMAC-SHA256）
调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存处理。
核心作用：根据商品 ID，获取商品标题、价格、SKU、库存、图文、类 目、销量、规格属性等全量详情数据。
- 拉取 Coupang 商品数据，拿到商品 ID、韩文标题、主图链接；
- 对图片做预处理过滤，剔除水印过重、拼图、分辨率过低素材；
- 调用 1688 图片搜索 API，返回一批相似度候选商品；
- 根据相似度阈值过滤，拿到候选 1688 商品 id 列表；
- 调用商品详情接口获取批发、SKU、供应商数据；
- 将货源候选列表与 Coupang 商品 ID 关联存入数据库；
- 人工复核做兜底校验。
项目踩坑实录（真实遇到的问题）
坑 1：Coupang 商家二次修改图片，直接拉低检索相似度
很多韩国卖家拿到国内货源图片之后，会重新修图：更换背景、叠加韩文文字水印、调色、裁剪画面、增加模特滤镜。 原图特征被改动，直接导致图片搜索返回的相似度大幅下跌，很多同款商品直接检索不到。
踩坑表现：明明是同款货源，相似度只有 0.4‑0.5，直接被阈值过滤掉，召回失败。
✅处理方案
- 优先取商品第一张主图，避开细节图、场景图；
- 增加图片简易检测逻辑，文字占比过高的图片打上标记，降低该图片检索任务优先级；
- 业务层放宽相似度下限，同时增加二次过滤规则，不能单纯依靠相似度做最终判定。
坑 2：图片搜出来图片一样，但实物不是同款（高危错配）
这是最致命的业务坑。 1688 大量商家共用同一张商品效果图，图片视觉几乎一模一样，但是材质、规格、尺寸完全不同。比如同款外观饰品，一个合金，一个纯银；同款外壳，内部配件版本不一样。
踩坑表现：API 返回相似度 0.85 以上，看起来高度匹配，实际货源不能用，如果程序自动采信这条数据，后续定价、采购全部出错。
✅处理方案
重要原则：图片搜索 API 只做候选召回，不做自动确认匹配
- 绝不直接把 top1 结果直接写入正式业务库；
- 一次返回多条候选货源，全部存入候选池；
- 增加类目校验，Coupang 类目翻译映射 1688 类目，过滤跨大类目的候选；
- 必须保留人工复核环节，系统只做辅助，不做全自动溯源。
坑 3：批量任务并发，接口限流、返回空结果
项目初期做测试，少量商品调用一切正常。一跑上万条批量溯源任务，短时间并发打上去，就频繁出现返回空列表、请求超时、接口拒绝访问。
✅处理方案
- 改用消息队列异步任务架构，控制 QPS，削峰处理；
- 增加本地缓存，同一个图片 url 检索结果缓存一段时间，避免重复请求；
- 增加重试机制，区分真正无结果和限流报错，不要盲目重试；
- 对任务做分片，分批执行，不要一次性全量压入队列。
坑 4：语言不通，无法简单文本比对校验
Coupang 是韩文，1688 是中文，没办法直接对比标题相似度来校验匹配结果。 想做文本校验，就要引入翻译接口，翻译成本增加，同时翻译本身也会有偏差。
✅处理方案
- 主要依靠图片相似度 + 类目匹配双重校验；
- 翻译只做辅助参考，不作为匹配的核心判断条件；
- 重点看规格参数、价格区间是否符合业务常识，过滤离谱价差的候选。
坑 5：一张图返回几十条货源，价格参差不齐
同一个商品图，1688 上十几家工厂在卖，起批、价格、质量参差不齐。直接取第一条，经常拿到高价小作坊货源，不适合跨境采购。
✅处理方案
- 对候选列表做多维度加权排序：相似度权重最高，叠加销量、价格区间、商家实力做权重；
- 业务系统展示多条候选给到运营人员选择，而不是程序自动选一个。
