magento 2 REST API带了Bearer Token还是401，先查ACL还是Nginx？
2025/11/18 上午10:31
alwayly
同一个 Token 在本机 curl 可用，经过正式域名就 401，这时我不会立刻重建 Integration。先判断 Magento 有没有收到 Authorization 头。继续阅读
Magento 2 REST接口上传文件收到413 Request Entity Too Large
2026/1/1 上午11:53
alwayly
413通常在请求进入Magento前由Web服务器返回，需要把Nginx、代理和PHP限制逐层对齐。继续阅读
Magento 2 REST响应因extension_attributes.xml类型错误返回500
2026/1/5 上午10:32
alwayly
扩展属性声明的type必须与getter返回值完全一致，否则业务已执行完仍会在响应序列化时500。
继续阅读Magento 2 Swagger显示Failed to load API definition如何修复？
2026/2/2 上午10:51
alwayly
Swagger页面加载失败通常是rest/all/schema生成异常，应从响应中的第一个自定义接口错误开始修。继续阅读
Magento 2 REST API报Property does not have corresponding setter
2026/2/3 下午1:33
alwayly
请求JSON字段会按Service Contract映射到setter，字段名、接口方法或类型任一不匹配都会在进入业务代码前失败。继续阅读
Magento 2 REST API调用成功但响应字段全部为空
2026/2/17 下午3:11
alwayly
接口返回对象已创建但字段为空，常见原因是Data Interface getter命名、实现类赋值或序列化声明不一致。继续阅读
Magento 2关联可配置子商品时报Child product attributes mismatch
2026/3/10 上午11:16
alwayly
通过REST或脚本关联子SKU时返回属性不匹配，不能跳过校验直接写catalog_product_super_link，否则前台组合会损坏。继续阅读
Magento 2 REST自定义接口接收对象数组时报Class does not exist
2026/3/17 上午9:53
alwayly
自定义REST接口传入items数组时，反序列化阶段报Class does not exist，业务方法甚至没有执行，根因通常在Service Contract类型声明。继续阅读
Magento 2 REST保存客户地址时报Custom attribute is invalid
2026/3/18 上午9:47
alwayly
REST创建客户地址时标准字段正常，自定义字段却返回Custom attribute is invalid。先核对属性实体、输入代码和前后台表单配置。
继续阅读Magento 2 REST API指定fields后SearchCriteria筛选失效
2026/3/23 上午10:27
alwayly
fields与searchCriteria同时使用时，参数拼接和URL编码错误会让过滤条件被截断或放进fields表达式。继续阅读
