Article
Adobe Commerce 图片已放上服务器,导入仍找不到,目录该怎样核对?
区分 Adobe Commerce 2.3.2 起的图片导入基目录、Images File Directory 和 CSV 文件名,先用默认目录的一行样本定位,避免把导出后的字母路径照搬成上传路径。

封面是根据官方文档整理的操作路径示意,非平台界面截图或已完成的验收记录。
先把“文件实际放在哪里”“导入目录字段填什么”和“CSV写什么”分开核对。Adobe Commerce及Magento Open Source官方文档说明,从2.3.2起,Images File Directory 指定的路径会拼接在图片导入基目录后;默认基目录是安装根目录下的 var/import/images,该字段留空即可使用默认目录。把服务器绝对路径或整段基目录再次填进字段,不应被当作通用写法。Adobe 商品图片导入
本篇处理本机服务器文件导入的路径交接,面向运营与维护者协作。使用外部完整图片URL或Remote storage时,要采用对应的官方流程;不能仅因文件名相同,就把三种存储方式混成一张配置表。
先做这三个确认
记录实际版本及采用的存储方式,2.3.2之前的目录说明不能直接套用。
用默认基目录、空目录字段和一个文件名组成最小对照,先排除路径重复。
导出CSV里的字母分层路径,不是要求设计师在导入目录里复制相同目录结构。
用一张图建立不含子目录的对照
在隔离测试环境或受控测试商品上,让有权限的维护者把一张已批准的图片放进实际安装对应的默认导入目录。运营只需取得确认过的相对位置和文件名,不应索取服务器密码,也不用为此自行调整文件权限。
为测试SKU准备只包含 sku 及相关图片列的CSV。默认目录里的图片,按官方文档只填写文件名;在 Images File Directory 留空。使用真实存在的测试SKU和文件,不要把本文演示值直接导入正式商品。
若这个对照能够找到图片,再核对原批次是否用了子目录、远程存储,或者把基目录重复写入字段。若对照也失败,先请维护者查实际安装位置、文件名大小写、文件存在性和读取证据,不靠不断修改CSV猜路径。
区分导出目录和导入来源目录
官方文档说明,Commerce会自行组织商品图片的字母目录结构;导出已有商品时能看到这些路径。新图导入时应描述导入来源的位置,不是提前猜它最终在商品媒体库里的保存路径。
例如导出文件曾出现一个按文件名组织的分层路径,不能据此认定新上传图片也必须放在那里。先确认本次源文件是否位于默认导入目录或其子目录,再按实际来源填写。若确需子目录,让维护者逐项给出基目录、相对目录和CSV引用的预期组合,并对照当前官方文档;不要一边迁移文件,一边同时修改三处路径。
可复制的路径交接表
以下是虚构练习,使用的是演示SKU和文件名,不是服务器检查结果。第一行是用于定位的最简组合,第二行展示常见的重复表达风险。
| 测试记录 | 实际来源位置 | Images File Directory | CSV中的base_image | 应做的判断 |
|---|---|---|---|---|
| 虚构TEST-CUP-A | 安装根目录下var/import/images/cup-front.jpg | 留空 | cup-front.jpg | 默认目录对照,实际结果待填写 |
| 虚构TEST-CUP-B | 与上一行相同 | 再次填写完整安装根路径 | cup-front.jpg | 先核对拼接语义,不扩大导入 |
| 你的SKU | 由维护者确认 | 记录实际字段 | 记录实际单元格 | 记录找到文件与否及错误信息 |
把表格与小样CSV一起交付,避免只发“图片已经上传”的截图。上传成功不能说明导入器查找的是同一个位置。多SKU对应关系可参照批量素材与SKU发布核对,但那张通用表不会解释本题的基目录拼接。
找到文件后,再看商品实际收到什么
先核对测试商品收到的是哪张图、放在什么角色,以及是否仍对应批准内容。按下载文件与批准预览的对应检查确认文件身份,不用相同文件名替代画面对照。
如果图片引用已经正确,而前台派生图仍有问题,不要继续改导入目录。官方文档明确指出,图片导入本身不会触发缩放,前台缩放涉及 pub/get.php;应把该事实交给维护者检查实际环境,而不是直接修改生产入口文件。若表现为页面仍显示旧图,可另用已发布图片版本核查定位具体请求。
只有小样的商品身份、来源路径、图片角色与实际页面均明确,才扩大批次。失败时保留原CSV、目录记录和脱敏错误,不反复重跑整批覆盖证据。
本文由 Itemlume 组织编辑,AI辅助起草;官方文档于2026年10月23日查阅,页面标示更新于2026年10月8日。本篇明确限定2.3.2起的本机导入基目录说明,未验证具体商家的版本、存储或服务器。表格为虚构练习,未执行导入或客户实测,外部维护不是 Itemlume 已接通能力。见编辑组织与证据政策及联系与纠错。