公众号素材
公众号素材页用于维护图片、语音、视频等永久素材，并为图文草稿、菜单回复和自动回复提供内容来源。当前前端位于 apps/web-antd/src/views/mp/material，后端接口由 MpMaterialController 提供。
素材类型与入口
| 类型 | 页面表现 | 后端能力 | 典型用途 |
|---|---|---|---|
| 图片 | 图片网格预览 | 上传永久素材、删除、分页 | 图文封面、自动回复图片、菜单回复 |
| 语音 | 音频控件播放 | 上传永久素材、删除、分页 | 语音回复、活动播报 |
| 视频 | 视频控件预览，新建视频弹窗 | 上传永久素材、删除、分页 | 视频素材回复、图文引用 |
| 图文内图片 | 编辑器上传 | /mp/material/upload-news-image | 图文正文插图 |
操作链路
使用建议
- 先选择公众号账号：素材是按公众号隔离的，上传前必须确认
accountId。 - 永久素材谨慎删除：删除会影响菜单、自动回复、图文草稿中引用该
mediaId的内容。 - 图文封面优先使用图片素材：草稿列表会根据
thumbMediaId回查本地素材 URL，便于后台预览封面。 - 视频素材信息要完整：视频通常需要标题、简介和文件，上传失败时优先看微信返回的格式限制。
排查清单
| 现象 | 优先检查 |
|---|---|
| 素材列表为空 | 是否选择公众号；素材类型 Tab 是否正确；permanent=true 查询条件是否匹配 |
| 上传失败 | 权限 mp:material:upload-permanent；文件大小/格式是否符合微信限制 |
| 图文封面不显示 | thumbMediaId 是否能在本地素材表查到；素材 URL 是否可访问 |
| 删除后仍被引用 | 菜单、自动回复、草稿是否还引用该 mediaId |
