Opencart3.0.2用TRestRequest上传图片API成功但无图片问题求助

排查步骤 #

• 先读取完整接口响应内容，不要仅通过状态码判断请求结果。OpenCart 接口常出现状态码200，但响应体JSON中携带error字段的情况，比如权限不足、文件名非法、目录无写入权限等错误都会返回伪成功响应，优先查看响应体内的报错信息。
• 检查你使用的x-oc-restadmin-id对应账号的权限，确认账号已开通catalog/product修改权限与文件上传权限。同时检查OpenCart后台设置的上传规则，确认待上传的image.jpg无特殊字符、大小不超过上传限制、后缀属于允许上传的格式范围。
• 确认请求参数中的商品id真实存在，若传入的商品ID不存在，接口会返回成功但不会存储图片也不会做关联。
• 检查OpenCart服务端image/catalog目录的读写权限，Linux环境下需确保运行Web服务的用户（通常为www-data）对该目录有至少755权限，否则文件写入失败但不会抛出明确错误。
• 可先用Postman调通同接口的上传逻辑，抓包对比Postman请求和你的代码请求的头、体格式差异，快速定位参数问题。

问题根因与修复代码 #

你当前的代码错误是直接将图片二进制流作为Raw请求体提交，OpenCart 3.0.2的商品图片上传接口要求使用multipart/form-data格式的表单提交，文件需放在file表单字段中，参考修复后的代码：

mRestClient.BaseURL := ...; // opencart url
mRequest.Resource := 'index.php?route=rest/product_admin/productimages&id=...';
mRequest.Params.Clear;
// 直接指定参数类型，避免索引错误
mRequest.AddParameter('x-oc-restadmin-id', token, TRESTRequestParameterKind.pkHTTPHEADER);

jpg := TMemoryStream.Create;
try
  jpg.LoadFromFile('image.jpg');
  // 按表单格式上传文件，指定字段名、文件流、MIME类型、文件名
  mRequest.AddBody('file', jpg, TRESTContentType.ctIMAGE_JPEG, 'image.jpg');
  // 可选：指定上传后存储的目录，需确保目录已存在
  mRequest.AddParameter('directory', 'catalog/product', TRESTRequestParameterKind.pkGETorPOST);
  mRequest.Execute;
  // 打印返回结果排查问题
  Writeln(mRequest.Response.Content);
finally
  jpg.Free;
end;

额外注意事项 #

• OpenCart 3.0.2默认会自动重命名含中文、特殊字符的文件名，若自定义上传目录，需提前在服务端创建对应目录，否则会上传失败。
• 若你使用的是第三方RestAdmin插件，确认插件版本适配OpenCart 3.0.2，旧版本插件的图片上传接口存在写入逻辑漏洞，会出现返回成功但未存文件的问题。

内容的提问来源于stack exchange，提问作者Muhammed Balcıoğlu