Sitecore媒体库图片在CM实例页面编辑器不显示但CD实例正常

这种CM端媒体加载失败但CD完全正常的情况我之前在项目里碰到过好几次，大概率是CM和CD之间的配置、权限或者缓存差异导致的，咱们一步步来排查解决：

1. 先排查媒体库权限配置 #

• 打开Sitecore Desktop进入Content Editor，选中媒体库的父文件夹（比如你提到的Upload），右键点击「Security」，检查你使用的编辑角色（比如Sitecore\Author）是否拥有Read和Read Media的权限。有时候批量导入媒体时，权限没正确继承，导致CM端编辑用户无法读取，但CD用的匿名角色权限是正常的。

2. 检查CM与CD的媒体处理配置差异 #

• 对比CM和CD的Sitecore.config（或自定义配置文件）里的<mediaRequestHandler>节点：
  • 重点看requireLicense属性：如果CM端这个值设为true，但媒体请求没有携带有效的认证Cookie，就会返回错误。可以临时把CM的requireLicense改成false测试（测试完记得改回），看图片是否能加载。
  • 确认mediaUrlPrefix配置一致，CM和CD的~/media/前缀要统一，避免路径解析出错。

3. 清理CM端媒体缓存并重建索引 #

• 手动删除CM实例Website/App_Data/MediaCache下的所有文件，然后重启CM站点，这能解决缓存损坏导致的媒体加载问题。
• 同时重建媒体库索引：进入Sitecore Launchpad → 控制面板 → 索引 → 重建索引，选中sitecore_media_index完成重建。

4. 验证媒体项的发布状态 #

• 虽然CD能显示，但还是要确认这些有问题的媒体项是否已经发布到CM的web数据库。有时候发布任务可能漏了部分媒体，或者媒体项的版本在web库中缺失。
• 操作：在Content Editor中选中媒体项，切换到「Versions」标签，查看是否有已发布的版本；或者右键点击「Publish Item」重新发布单个媒体项测试。

5. 排查CM端的认证与请求状态 #

• 先登录CM后台，再在同一个浏览器窗口直接访问媒体路径（比如mysite.prod-cm.com/~/media/Upload/exampleImage.ashx），如果能正常显示，说明是未认证导致的问题。可以调整CM的媒体请求认证规则，或者确保编辑会话的Cookie能被媒体请求携带。
• 打开浏览器开发者工具，查看媒体请求的响应状态码：
  • 403：大概率是权限或认证问题；
  • 500：查看CM的Website/App_Data/logs日志，找到具体的异常信息（比如图片格式不支持、文件损坏、媒体处理器报错）。

内容的提问来源于stack exchange，提问作者Erica Stockwell-Alpert