通过连接 Magento 和 Akeneo，在一个地方管理你的产品信息——我们如何最终实现“耶！”[案例研究]

如何高效管理多渠道产品信息？Kaliop 实施 Magento 与 Akeneo 集成案例解析

Kaliop 近期承接了一项 Akeneo PIM 项目。客户为南美知名电气配件销售商，计划从单一 Magento 1 店铺扩展业务。为解决“避免重复劳动、统一准备多渠道产品”的难题，客户决定引入 PIM（产品信息管理）系统。作为 Akeneo 专家，我们提供了以下解决方案。

Akeneo 与 PIM 的核心价值

PIM 是产品数据管理的核心枢纽，用于集中存储描述、媒体等信息（支持自动导入或手动录入），并统一管理多渠道分发（如商城、目录、邮件列表等）。其优势在于“一次录入，多端分发”，显著提升创建、管理及发布效率。基于此目标，项目范围确定为三项任务：

– 将 Magento 1 升级至 Magento 2
– 实现 Magento 与 Akeneo 对接
– 清理冗余属性集/属性

首次尝试：官方迁移工具遇阻

初期采用 Magento 官方数据迁移工具进行版本升级，虽在小规模测试中通过，但在实际应用中彻底失败。该工具在属性迁移时频繁报错且无有效日志。经调研发现此为普遍问题且现有方案无效，我们随即决定自研升级工具。

二次攻坚：优化 API 性能瓶颈

原计划使用 Magento 2 API 处理数据，但上传产品图片时响应过慢，无法满足需求。因 API 强制要求传输文件内容而非仅文件名，我们调整策略，修改产品导出逻辑直接操作数据库。此举大幅提升效率：处理速度从“每产品 10 秒”跃升至“每 10 秒 300 个产品”。

核心突破：Magento 与 Akeneo 深度集成

这是项目的关键环节。为实现数据互通，我们采取了以下措施：

1. 数据导入：开发控制台命令，生成符合 Akeneo 格式的 CSV 文件。
2. 数据导出：采用官方推荐的开源方案 Pimgento。
3. 难点攻克：针对 WYSIWYG 编辑器内联媒体，将 Magento 标签映射为标准 HTML；针对图库限制（Akeneo 单字段不支持多图），新增专用属性以适配。

收尾工作：数据清洗与映射

针对配置中过时的属性和属性集，我们在导出脚本中增加了映射与过滤机制，确保数据整洁准确。

项目成果总结

本项目耗时主要集中在 Magento 1 至 2 的升级（约占 70%），自研工具不仅解决了问题，还深化了对 Magento 内核的理解。相比之下，Magento 与 Akeneo 的集成仅占 20% 时间，且实现了高效同步：在 Akeneo 修改属性即可实时同步至 Magento。此外，Akeneo 在同服务器环境下响应优于 Magento 后台，支持更多用户并发处理产品。最终，我们为客户交付了高性能的集中化产品管理系统。

作者：
Arkadiusz Tokarczyk，高级开发人员，Kaliop Poland
Daniel Cisek，高级开发人员，Kaliop Poland