CRMEB Pro 商品复制/导入二开：为什么从外部平台搬商品最容易把 SKU 和图片搞乱？

摘要

商品二开里，“复制一个外部平台商品”看起来很像运营工具：粘贴链接、解析标题、下载图片、生成规格、保存商品。真正落地时会发现，它其实同时碰到图片远程下载、分类映射、SKU 组合、条码去重、详情富文本、商品状态、运费模板和供应商权限。

CRMEB Pro 当前商品模块已经有两条典型入口：一条是复制外部平台商品，一条是 Excel 批量导入商品。二开时如果只关心商品主表字段，很容易出现图片丢失、规格组合错位、条码重复跳过、详情内容显示异常等问题。

这篇结合项目现有实现，梳理商品复制和导入二开的关键链路。

一、先看后台入口，不要直接写一个“导入接口”

后台商品相关路由集中在crmeb_pro/route/admin.php的product分组里，和复制、导入相关的入口包括：

GET product/copy_config 获取复制商品配置 POST product/copy 复制其他平台商品 POST product/crawl/save 保存采集商品数据 POST product/product_import 商品导入 POST product/import_erp_product 导入 ERP 商品到平台 POST product/generate_attr/:id/:type 生成商品规格列表

后台前端接口封装在crmeb_pro_admin/src/api/product.js，对应方法包括：

copyConfigApi 获取复制商品配置 crawlFromApi 获取外部商品数据 crawlSaveApi 保存采集商品数据 generateAttrApi 生成规格属性 productImport 商品导入

二开建议先复用这些入口和命名，不要另起一套“临时导入接口”。商品导入不只是插入一条商品记录，还要进入商品保存链路、规格保存链路和缓存清理链路。

二、复制外部商品时，图片不是简单保存 URL

复制外部商品的核心服务在：

crmeb_pro/app/services/product/product/CopyTaobaoServices.php

copyProduct()会根据系统配置选择复制方式，然后把外部平台返回的数据整理成当前商品编辑页能识别的结构。这里有几个关键动作：

1. 解析外部平台商品数据 2. 整理 sku_props 并转换成 specs 3. 准备附件分类“远程下载” 4. 下载主图和轮播图 5. 限制轮播图数量 6. 组装分类、运费模板、规格、活动顺序等默认值

这也是为什么很多商品复制二开会翻车：外部平台图片地址能访问，不代表能直接作为商城图片使用。项目里会把远程图下载到附件体系里，后续商品详情、列表缩略图、水印图才好统一处理。

二开时建议保留这个策略：

外部图片先进入附件体系 主图、轮播图、详情图分别处理 失败时返回明确错误，不要静默丢图 轮播图数量遵守当前商品表单限制 保存前统一把反斜杠路径转成正斜杠

三、Excel 导入更像“批量调用商品保存”

商品批量导入入口在后台 Controller：

crmeb_pro/app/controller/admin/v1/product/StoreProduct.php productImport()

真实处理在：

crmeb_pro/app/services/product/product/StoreProductServices.php productImport()

这个方法会读取商品导入模板，把 Excel 中的多行 SKU 按商品 ID 归组，再组装成商品保存需要的数据结构，最后逐个调用：

saveData(0, $info)

也就是说，导入不是绕过商品保存流程直接写库，而是尽量复用商品新增逻辑。这样 SKU、库存、详情、分类、品牌、活动顺序、配送方式等字段才能跟后台手动新增保持一致。

二开导入模板时，重点要确认这些字段：

product_type 商品类型 cate_id 分类映射 brand_id 品牌映射 store_name 商品名称 slider_image 轮播图 description 详情内容 spec_type 单规格/多规格 attrs SKU 明细 items 规格项 code 商品编码 bar_code 商品条码 min_qty 起购数量 product_clear 适用群体

新增导入字段时，不要只改 Excel 读取，还要确认saveData()能接收并保存。

四、SKU 导入最容易错在两个分隔符

当前导入逻辑会把 Excel 里的规格数据拆成两类：

sku_value 用于每个 SKU 的 detail，例如 颜色=红色;尺码=L sku_type_value 用于规格项 items，例如 颜色=红色,蓝色;尺码=M,L

多规格商品会把每一行 SKU 放入attrs，单规格商品会写入attr。每个 SKU 会包含：

price pic ot_price cost stock weight volume code bar_code

二开时最常见的问题是把规格项和 SKU 明细混在一起。比如sku_type_value只定义了颜色和尺码，但某一行sku_value少了一个尺码，后续生成规格组合时就可能对不上。

建议导入前做这些校验：

每个 SKU 的 detail 维度必须和规格项一致 规格名不要出现多余空格 规格值不能为空 多规格商品必须至少有一行有效 SKU 价格、库存、重量、体积必须做数字校验

如果要扩展外部 SKU 编码，建议新增独立字段，例如external_sku_code，不要把系统内部unique改成外部编码。

五、条码重复时，系统会跳过整件商品

当前导入会提前读取已有 SKU 的：

code bar_code

如果导入行里的编码或条码已经存在，会把对应商品 ID 放入跳过列表，最后返回：

all 总商品数 success 成功数 jump 跳过数 fail 失败数

这点二开时很值得保留。因为商品条码和 SKU 编码通常会参与仓储、扫码、ERP 同步和售后识别，重复导入比导入失败更危险。

如果业务希望“重复条码更新旧商品”，也不要直接覆盖，建议改成明确模式：

导入新增模式：重复条码跳过 导入更新模式：按外部商品编码匹配后更新 导入预检模式：只返回冲突清单，不写数据

这样运营可以先处理冲突，再决定是否导入。

六、详情内容要兼容图片数组和富文本

导入服务里有一个很实用的处理方法：

processDescription()

它会判断详情内容是否已经包含<p>标签。如果已经是富文本，就直接保留；如果只是用分号分隔的图片地址，就自动拼成带<img>的 HTML。

这类兼容非常适合二开保留，因为不同来源的商品详情格式不一样：

外部平台可能返回富文本 Excel 模板可能只填多张图片 ERP 可能返回纯文本或图片数组

建议统一在服务层做格式转换，前端只负责展示，不要让每个页面各自判断详情格式。

七、ERP 导入适合走队列，供应商端不要默认开放

import_erp_product()会读取 Excel 中的spu列，并准备把 SPU 加入同步队列。当前代码里供应商登录会直接返回“暂无权限”。

这个设计有两个原因：

ERP 同步通常影响平台级商品池 SPU 同步可能触发远程接口、图片下载、SKU 写入和库存同步

如果二开要接真实 ERP，建议按这个方向扩展：

1. 上传文件只做解析和预检 2. SPU 去重后进入队列 3. 队列按批次同步商品 4. 失败记录写入同步日志 5. 后台提供重试入口 6. 供应商端必须按权限隔离可同步范围

不要在请求里同步几百个商品，否则接口超时和半成功状态会很难处理。

八、关键代码/目录说明

crmeb_pro/route/admin.php 商品复制、导入、规格生成、商品保存等后台路由。 crmeb_pro_admin/src/api/product.js 后台前端商品 API 封装，包含 copyConfigApi、crawlFromApi、crawlSaveApi、generateAttrApi。 crmeb_pro/app/controller/admin/v1/product/StoreProduct.php 商品后台 Controller，包含 productImport、import_erp_product、getProductSaveFields 等入口。 crmeb_pro/app/services/product/product/CopyTaobaoServices.php 外部平台商品复制服务，处理远程商品数据、图片下载、规格转换。 crmeb_pro/app/services/product/product/StoreProductServices.php 商品保存和导入主服务，productImport 会整理 Excel 数据并复用 saveData。 crmeb_pro/app/services/product/sku/StoreProductAttrServices.php 规格保存服务，负责校验 SKU 组合并保存规格。

九、注意事项

• 不要绕过saveData()直接写商品主表。
• 外部图片建议进入附件体系，不要长期依赖第三方图片 URL。
• SKU 导入要校验规格项和 SKU 明细是否一一对应。
• 条码、商品编码重复时先预检，不要静默覆盖。
• ERP 同步建议走队列和日志，不要在接口里同步大量商品。
• 供应商端导入权限要单独校验，避免导入平台级商品。
• 新增导入字段时，同步维护安装 SQL、升级 SQL 和字段 COMMENT。

标签建议

CRMEB CRMEB Pro 二次开发 商品导入 SKU ThinkPHP 商城系统