Cypress集成AWS S3遇Missing credentials错误，求排查

1. 确认AWS SDK的运行环境 #

Cypress测试用例默认运行在浏览器环境，而浏览器无法直接读取本地~/.aws目录下的凭证文件。必须把S3操作放到Cypress的**Node任务（task）**中执行，才能获取本地凭证或环境变量。

错误示例（直接在测试用例中初始化SDK）：

// 测试用例代码（浏览器环境，无法读取本地凭证）
import { S3Client, ListObjectsCommand } from "@aws-sdk/client-s3";

const s3Client = new S3Client({ region: "your-region" });
cy.wrap(s3Client.send(new ListObjectsCommand({ Bucket: "your-bucket" })));

正确实现：

1. 在cypress.config.js中注册Node任务：

const { defineConfig } = require("cypress");
const { S3Client, ListObjectsCommand } = require("@aws-sdk/client-s3");

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on("task", {
        async listS3Objects(bucketName) {
          const s3Client = new S3Client({ region: "your-region" });
          const command = new ListObjectsCommand({ Bucket: bucketName });
          const response = await s3Client.send(command);
          return response.Contents;
        },
      });
    },
  },
});

2. 在测试用例中调用任务：

cy.task("listS3Objects", "your-bucket-name").then(objects => {
  console.log("S3对象列表:", objects);
});

2. 显式凭证参数校验 #

如果手动传入密钥，注意参数名拼写：AWS SDK v3要求credentials对象包含accessKeyId和secretAccessKey（不是accessSecretKey）。

错误示例：

const s3Client = new S3Client({
  region: "your-region",
  credentials: {
    accessKeyId: "xxx",
    accessSecretKey: "yyy" // 参数名错误
  }
});

正确示例：

const s3Client = new S3Client({
  region: "your-region",
  credentials: {
    accessKeyId: "YOUR_ACCESS_KEY",
    secretAccessKey: "YOUR_SECRET_KEY"
  }
});

3. 环境变量与本地文件检查 #

• Mac/Linux：确保~/.aws/config和~/.aws/credentials格式正确，且终端启动Cypress时环境变量已生效（可在~/.bashrc或~/.zshrc中配置后重启终端）。
• Windows：
  • setx设置的环境变量需重启终端才会生效
  • AWS SDK默认读取%USERPROFILE%\.aws\credentials文件，若你的文件名为awscredentials（少了末尾的s），需重命名为credentials，或设置AWS_SHARED_CREDENTIALS_FILE指向自定义路径
  • 可在Node任务中打印环境变量验证：

    console.log("AWS_SDK_LOAD_CONFIG:", process.env.AWS_SDK_LOAD_CONFIG);
    console.log("AWS_ACCESS_KEY_ID:", process.env.AWS_ACCESS_KEY_ID);
    

4. 凭证文件格式校验 #

~/.aws/credentials文件需为ini格式：

[default]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

~/.aws/config文件格式：

[default]
region = us-east-1
output = json

若使用非默认profile，需在SDK初始化时指定：

const s3Client = new S3Client({
  region: "your-region",
  profile: "your-profile-name"
});

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