易优CMS阿里云OSS上传图片报错_AccessKey配置_Bucket域名_解决步骤
易优CMS配置阿里云OSS上传图片报错，先检查AccessKey配置。后台"系统"→"基本参数"→"附件设置"里找到OSS配置，AccessKey ID和AccessKey Secret要填对。这两个信息在阿里云控制台→RAM访问控制→用户里创建，给用户分配AliyunOSSFullAccess权限。复制密钥时注意不要有多余空格，空格会导致签名验证失败。
Bucket名称和地域节点要对应。Bucket名在阿里云OSS控制台创建，名称全局唯一。地域节点（Endpoint）要选和Bucket同地域的，比如Bucket在华东1（杭州），Endpoint填`oss-cn-hangzhou.aliyuncs.com`。内网访问填`oss-cn-hangzhou-internal.aliyuncs.com`（服务器在阿里云同地域时用内网，流量免费）。地域填错会报"NoSuchBucket"或连接超时。
上传目录权限问题。OSS配置里有"上传目录"字段，填Bucket下的子目录名，比如`images`。这个目录不需要手动在OSS创建，上传时自动建。但如果填了不存在的Bucket根目录路径格式错误，会报错。建议只填目录名，不要加斜杠。文件命名规则保持默认，不要用中文文件名，部分情况下中文编码问题导致上传失败。
域名绑定配置。OSS配置里有"访问域名"，填绑定到Bucket的自定义域名，比如`img.example.com`。这个域名要先在阿里云OSS控制台绑定，并在DNS解析里CNAME到Bucket的外网访问域名。没绑定自定义域名就填Bucket的默认外网域名（xxx.oss-cn-hangzhou.aliyuncs.com）。域名填错的话，图片上传成功但前台显示不出来，因为访问地址不对。
PHP的cURL扩展必须开启。易优CMS通过OSS SDK上传，依赖cURL。宝塔PHP设置→安装扩展，确认curl已安装。同时开启openssl，OSS用HTTPS通信需要openssl。扩展装完重启PHP。低版本PHP的cURL有SSL证书验证问题，升级PHP到7.2以上，或者在SDK里临时关闭证书验证（不推荐生产环境用）。
报错"InvalidAccessKeyId"说明AccessKey ID不存在或被禁用。去阿里云RAM控制台检查用户状态，用户被禁用或删除了就重新创建。报错"SignatureDoesNotMatch"说明Secret错了，重新生成Secret并复制正确。报错"AccessDenied"说明权限不够，给RAM用户加AliyunOSSFullAccess策略，或自定义策略只允许访问指定Bucket。
测试上传时先传一张小图（几十KB），排除文件大小限制。PHP的upload_max_filesize和post_max_size要调大，宝塔PHP设置里改，比如都设为50M。OSS本身没有文件大小限制（单个文件最大48.8TB），但PHP层面会限制。传大图失败的话检查这两个参数。配置正确后，后台上传图片会自动存到OSS，网站源服务器不占存储空间，适合图片多的站点。
更新时间：2026-08-26 18:05:03