Files
atlas-seller-kit/docs/reviews/ozon-image-delivery-diagnosis.md
T

5.1 KiB
Raw Blame History

Ozon 图片交付排查(2026-10-07)

商品 26662645-a6cf-4978-8fa1-154945bf2510,SKU「月读鼬【高约22CM】盒装」,货号 ShouBan-HYRZ-V1-001,Ozon product_id 6537891375。

已确认事实

  • 发布快照包含 3 张正式 PNG 素材,显示顺序未丢失。三张发布副本均能通过原交付域名下载,HTTP 200,尺寸均为 1086×1448,大小分别为 1,226,554、1,524,027、2,025,426 字节。
  • Ozon /v2/product/pictures/info 仅返回 1 张主图、0 张附加图;第 1、2 张交付链接均返回 request process failed: unknown error host unreachable。失败链接签名正确,截止时间为 2026-10-14 15:15:35(北京时间),并非签名过期。
  • 七牛只读域名配置显示 img-dev.atlas.joeyone.cn 为 geoCover=china、HTTPS、正常运行、七牛桶回源;没有 Referer/IP/UA 限制。结合 Ozon 抓取错误,当前大陆加速域名的跨境连通性是本次最明确的原因。
  • Atlas 发布任务在 2026-10-07 15:15:54 完成;Ozon 图片错误于约 15:17:12 出现。原流程收到商品 imported 就结束,图片仍在抓取,且 imported 分支丢弃平台警告。

本地修复与验证

Worker 收到 imported 后继续查询图片状态,等待完整结果;存在下载错误或缺图时保留导入身份、图片数量和脱敏提示。已创建商品不因缺图重新进入首次上架。发布结果界面对有提示的已导入任务使用警告样式,展示逐项说明;接口字段和数据库结构不变。

15 项发布 HTTP/数据库/Worker 回归通过,覆盖商品先导入、图片后到、1/3 缺图、完整成功、长时间未齐、平台警告持久化、签名链接脱敏与不重复导入。6 项既有 Worker 媒体交付/包装规格回归通过。Worker/Web 类型检查与构建、API 测试类型检查和差异检查通过;真实结果组件的模拟界面验证通过。没有修改真实商品资料或向 Ozon 提交写请求,未手动启停维护者服务。

已授权的线上恢复范围

  1. 将该七牛域名的加速区域从 china 改为 global,保留域名、HTTPS、回源和访问控制配置。此域名的其他图片也会使用新的加速区域。
  2. 域名变更生效后重新验证三张交付副本,生成新的短期签名地址。
  3. 通过 Ozon /v2/product/pictures/import 仅更新 ShouBan-HYRZ-V1-001 的原 3 张图片和顺序,以 primary_image 明确指定第一张、images 传其余两张;不调用商品导入更新价格、标题或属性。
  4. 查询图片导入任务和图片专用结果,必须确认主图加附加图共 3 张且无下载错误,才宣称该 SKU 恢复。

维护者已于 2026-10-07 确认执行。七牛区域变更请求于北京时间 20:56:36 受理(HTTP 200 / code 200),配置已显示 global;21:28:20 仍为 processing,域名、CNAME 和 HTTPS 保持不变。维护者随后要求停止监控,监控及其子进程已停止;暂停期间未向 Ozon 提交图片更新。维护者后续通知全球配置完成并明确要求继续,本次恢复已完成,详见下节。

实际恢复结果

  • 恢复前七牛接口已确认 geoCover=global、operatingState=success、HTTPS 与 CNAME 不变,配置更新时间为 2026-10-07T13:32:01.835Z。原三张交付副本重新下载均 HTTP 200,SHA-256 与冻结发布快照一致。
  • 第一轮图片任务 5770626999 已导入且无错误。仅提交三图的 images 后,平台先保留旧主图及三张附加图,随后收敛为三图,但内容顺序为 3、1、2。未仅凭任务 imported 或图片数量宣称恢复。
  • 核对官方 V2 请求 schema 后,第二轮任务 5770634249 显式传 primary_image=原第1张、images=[原第2张, 原第3张],最终任务 imported,无任务错误。
  • 最终图片查询为 1 张主图、2 张附加图,图片错误为空。下载 Ozon 三张实际图片后以统一尺寸 RGB 内容比对原图,匹配顺序为 1、2、3,平均像素差均为 0,确认主图与附加图顺序正确。
  • 仅调用图片专用更新接口,没有提交商品导入或价格/属性更新。前后核对 name、price、old_price、min_price、currency_code、description_category_id、type_id 一致;未改写 Atlas 草稿或历史发布记录。
  • 临时恢复脚本、任务状态文件与官方文档浏览器已清理,无持续监控进程,未手动启停维护者服务。

官方依据