无法通过公共URL访问上传至Cloudinary的PDF文件该如何解决

问题触发原因 #

Cloudinary为避免恶意资源滥用，默认对非图片/视频/音频类的文件设置了公开交付限制，PDF属于默认拦截的格式范围，尤其免费账号默认会开启该限制。

解决步骤 #

• 第一步：调整账号全局安全配置
  1. 登录Cloudinary控制台，进入「设置」页面
  2. 切换到「安全」选项卡，向下滚动找到「受限媒体类型」板块
  3. 取消application/pdf对应的勾选状态，保存配置
  4. 等待5-10分钟让配置全局生效后，重新访问PDF的公共URL测试
• 第二步：排查剩余异常配置（如果调整全局配置后仍无法访问）
  • 检查单资源权限：进入资源管理列表找到对应PDF，确认它的访问模式为Public，如果设置为Private或Authenticated需要调整为公开
  • 检查交付域名白名单：在安全设置的「允许交付的域名」板块，确认你发起请求的域名已被加入白名单，未在白名单内的域名请求会被拦截
  • 检查URL签名强制规则：如果账号开启了「所有资源访问必须携带签名」的规则，无签名的公共URL会被拦截，可按需关闭全局签名强制，或者给对应PDF生成带合法签名的访问URL

注：调整配置后如果仍有缓存，可在URL后加临时的查询参数（比如?v=1）跳过缓存测试

内容的提问来源于stack exchange，提问作者Mohsin Zahid