Cloudinary私有资源应用命名转换遭遇401错误求助

问题回顾 #

已开启Cloudinary账户的Strict Transformations，创建了t_thumbnail命名转换并加入允许列表，上传私有资源后，无论是通过API调用还是直接在URL中添加转换参数，均返回401错误。

排查与解决方案 #

1. 验证命名转换配置准确性

• 确认命名转换名称完全匹配：Cloudinary的命名转换区分大小写，检查允许列表中的名称与代码中使用的thumbnail是否完全一致，无拼写或大小写错误。
• 重新保存严格转换设置：进入Settings -> Security -> Strict Transformations页面，确认t_thumbnail在允许列表内，点击保存按钮确保配置生效。

2. 确保私有资源URL带签名

私有资源的访问必须包含有效签名，即使使用允许的命名转换也不例外：

• 检查Cloudinary配置：确保cloudinary.config中正确配置了api_secret，签名生成依赖该密钥。
• 调用cloudinary.image时指定资源类型：私有资源需显式声明type: 'private'，否则方法会默认按upload类型生成URL，导致签名无效。修正后的代码示例：

const createThumbnailPhoto = (cloudinaryPhotoId) => {
  const THUMBNAIL_NAMED_TRANSFORMATION = 'thumbnail';
  return cloudinary.image(cloudinaryPhotoId, {
    type: 'private',
    transformation: [THUMBNAIL_NAMED_TRANSFORMATION]
  })
}

3. 手动构造URL时的格式要求

若直接构造URL访问私有资源，需遵循正确格式：

https://res.cloudinary.com/<你的cloud名称>/private/<签名>/<时间戳>/t_thumbnail/<public_id>

签名需通过Cloudinary SDK或API生成，确保包含命名转换参数的签名逻辑正确。

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