编辑传了张8MB的活动图，接口报错40006；换张小图又报47001。做微信公众号开发，素材接口是编辑和开发者最容易起冲突的地方，编辑嫌开发者做的上传功能难用，开发者嫌平台限制太多，其实把限制清单摆出来，误会就消了。
临时素材和永久素材是两码事
临时素材有效期三天，适合客服消息这类短链路场景，用完即弃；永久素材长期有效但总量有限，图文、图片、视频、语音各有各的数量上限，加起来也就十几万条的量级，正常业务够用，但别拿它当网盘存图。上传方式也不一样：永久素材要按类型走对应接口，视频还得多传标题和描述。搞混了类型，报错信息看着云里雾里，其实原因就一条。还要提醒一句，素材接口上传用的不是普通表单，字段名、编码方式都有讲究，用成熟的上传库，别手写multipart，手写一次错三次。
高频报错对照自查
- 40006：图片大小或格式不合规，压缩后再传
- 47001：解析body失败，多半是上传方式没用对multipart
- 40007：media_id不存在，检查素材是否过期或传错账号
- 45009：当日上传配额用完，查有没有循环重传
- media_id落库存好索引，别每次现查素材列表
图文素材另有一层坑：正文里的图片外链在公众号内可能不显示，要走平台的转存接口把图片换成微信域名地址；封面上传后拿到的thumb_media_id要准确回填，填错了图文直接发不出去。转存接口有每日次数限制，批量处理图文时安排在低峰期，一次转存失败就隔几秒重试，别急着重连。这些细节文档里都有，只是藏得深，没人细看。
给编辑配一个好用的后台
素材的media_id也要妥善管理：上传成功后把id、类型、标题存进自己的数据库，建立索引，别每次用都去拉素材列表翻页找。微信的素材列表接口翻起来很慢，一页二十条，上千条素材的账号翻一遍要几分钟，体验和效率都差。自建索引之后，素材调用毫秒级响应，这是很多团队上线后才补的课。素材管理的体验直接影响运营效率，建议交付时给编辑做一个本地素材库，上传后自动压缩到合规尺寸，起好标题打好标签，再同步到微信素材库，找历史素材不用翻微信后台那口深井。比格网络给客户做微信公众号开发时，这块通常是标配，编辑用得顺手，开发者也少挨骂。另外素材库的回收也要有机制，过期活动的素材及时归档，免得编辑在海量旧图里大海捞针，一个功能两头受益。素材这块的限制年年微调，上线前再对一遍官方文档总没错。
