易优CMS阿里云OSS上传图片报错_NoSuchBucket_Endpoint_权限全解
易优CMS配置阿里云OSS上传报错，按错误码精准排查。
配置回顾（后台→系统→基本参数→附件设置→OSS）： - AccessKey ID、AccessKey Secret - Bucket名称 - Endpoint（地域节点） - 上传目录 - 访问域名
错误码1：NoSuchBucket - 原因：Bucket名称错误，或Bucket和Endpoint地域不匹配。 - 排查：登录阿里云OSS控制台，确认Bucket存在，复制准确名称。 - Endpoint必须和Bucket同地域。Bucket在杭州，Endpoint必须是oss-cn-hangzhou.aliyuncs.com，不能填上海的。 - 修复：填正确的Bucket名和对应地域的Endpoint。
错误码2：AccessDenied - 原因：RAM用户没有该Bucket的读写权限。 - 排查：RAM控制台→用户→权限，看是否有AliyunOSSFullAccess或自定义策略。 - 修复：添加AliyunOSSFullAccess权限，或自定义策略允许访问指定Bucket。 - 自定义策略示例： ``` {"Version":"1","Statement":[{"Effect":"Allow","Action":["oss:*"],"Resource":["acs:oss:*:*:bucket名","acs:oss:*:*:bucket名/*"]}]} ```
错误码3：InvalidAccessKeyId - 原因：AccessKey ID不存在、被禁用、被删除。 - 排查：RAM控制台看用户状态和AccessKey状态。 - 修复：启用用户，或重新创建AccessKey。 - AccessKey Secret只在创建时显示一次，忘了重新生成。
错误码4：SignatureDoesNotMatch - 原因：AccessKey Secret错误，或签名计算时参数有问题。 - 排查：重新复制Secret，确保没有空格、换行。 - 修复：重新生成AccessKey，准确复制ID和Secret。 - 检查服务器时间，时间差太大签名会失效：`ntpdate ntp.aliyun.com`同步。
错误码5：连接超时/无法连接 - 原因：Endpoint错误、网络不通、内网Endpoint用在外网环境。 - 排查：SSH执行`curl -I Endpoint地址`看能否连接。 - 阿里云服务器同地域用内网Endpoint（带-internal），其他服务器用外网Endpoint。 - 修复：换成正确的Endpoint，外网环境用外网地址。
错误码6：上传成功但图片不显示 - 原因：访问域名配置错误，或Bucket权限不对。 - 排查：OSS控制台→Bucket→权限管理，读写权限设为"公共读"（网站图片需要公开访问）。 - 访问域名：绑定了自定义域名的填自定义域名（如img.example.com），没绑定填Bucket默认外网域名。 - DNS解析：自定义域名要CNAME到Bucket外网域名。 - 修复：设公共读，填正确访问域名，配置DNS。
错误码7：文件上传失败（400 Bad Request） - 原因：上传目录配置错误，或文件名含特殊字符。 - 排查：上传目录只填目录名（如images），不要加斜杠或绝对路径。 - 文件名用英文数字，中文文件名部分情况下编码问题。 - 修复：调整上传目录配置，重命名文件。
错误码8：PHP扩展缺失 - 原因：curl或openssl扩展未开启。 - 排查：phpinfo看curl和openssl。 - 修复：宝塔PHP设置→安装扩展→装curl和openssl→重启PHP。
测试流程： 1. 先用OSS官方工具（ossbrowser）测试同一对密钥能否上传。 - 能上传：密钥和权限没问题，是易优配置问题。 - 不能上传：密钥或权限问题，先修OSS侧。 2. 易优后台传一张50KB小jpg，看具体报错。 3. 查OSS访问日志（OSS控制台→日志管理），看请求的详细错误。
配置成功验证： - 后台上传图片，看是否存到OSS（OSS控制台文件管理确认）。 - 前台图片URL是访问域名，能正常显示。 - 图片多的站点，服务器磁盘不增长（图片都在OSS）。 - 访问速度快（OSS有CDN加速）。
OSS适合图片多的站点（电商、资讯），节省服务器存储和带宽。配置注意Bucket名、Endpoint、权限三个关键点，大部分报错都是这三个的问题。
更新时间：2026-08-26 18:00:04