配置AWS凭证后multer-s3上传S3仍报CredentialsError如何解决

• 环境变量未正确加载：代码中读取的process.env.AWS_ID、process.env.AWS_SECRET实际为undefined。常见触发场景包括：未在项目入口最顶部初始化dotenv配置、.env文件未放在node进程运行的根目录、.env内定义的变量名和代码中读取的名称不一致、变量值前后夹带多余空格/引号等无效字符。
• S3客户端缺失必填配置：创建aws.S3实例时未指定region参数，SDK会默认请求全局S3端点，若practiceguitar存储桶实际创建在其他区域，请求会被服务端拦截，返回凭证类错误。
• 凭证有效性/权限不足：传入的AccessKey、SecretKey已被删除、禁用或过期，或是密钥绑定的IAM身份没有practiceguitar桶的s3:PutObject上传权限，都会触发凭证校验失败。
• 依赖版本不兼容：multer-s3和aws-sdk存在版本对应关系，v2版本的aws-sdk需要搭配multer-s3@2.x使用，v3版本的AWS SDK（包名为@aws-sdk/client-s3）需要搭配multer-s3@3.x使用，版本不匹配会导致配置参数解析异常，抛出凭证错误。
• 冗余配置干扰：multer同时配置了本地存储路径dest: "uploads/"和S3存储引擎，虽然不会直接导致凭证错误，但可能引发配置优先级混乱，干扰问题排查。

• 先校验环境变量加载状态：在初始化S3客户端的代码前增加日志，打印process.env.AWS_ID和process.env.AWS_SECRET的值，确认能读到正确的密钥字符串，无多余空格、引号。如果使用dotenv管理环境变量，必须保证require('dotenv').config()是项目入口文件执行的第一行代码，且.env文件放在启动node命令时的工作目录根路径。
• 补全S3客户端的区域配置，填入practiceguitar存储桶实际所属的区域，示例代码如下：

const s3 = new aws.S3({
  credentials: {
    accessKeyId: process.env.AWS_ID,
    secretAccessKey: process.env.AWS_SECRET,
  },
  region: "ap-northeast-2", // 替换为存储桶实际所在区域，例如东京是ap-northeast-1，法兰克福是eu-central-1
});

• 校验凭证有效性和权限：登录AWS IAM控制台，确认当前使用的AccessKey处于启用状态，且绑定的策略包含对practiceguitar桶的上传权限。初始化S3实例后可打印s3.config.credentials，确认SDK实际加载的凭证和你预期的一致，排除SDK自动读取了本地~/.aws/credentials下其他无效密钥的问题。
• 对齐依赖版本：根据自己使用的AWS SDK版本安装对应版本的multer-s3，避免版本不兼容问题。
• 清理multer冗余配置，删除和S3存储冲突的dest字段：

export const uploadFiles = multer({
  limits: {
    fileSize: 10000000,
  },
  storage: multerUploader,
});

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