在SvelteKit中用AWS SDK v3读写S3遇凭证加载问题求解决

你在SvelteKit环境下使用@aws-sdk/client-s3读写S3存储桶时遇到了如下错误：

CredentialsProviderError: Could not load credentials from any providers
at /repo-location/node_modules/@aws-sdk/credential-provider-node/dist-cjs/defaultProvider.js:13:11

问题根源在于AWS SDK默认会查找process.env中的凭证变量，但SvelteKit的环境变量处理逻辑与Node.js原生环境不同，不能直接把SvelteKit的env对象传给S3Client配置。

正确实现方式 #

1. 配置私有环境变量 #

在项目根目录的.env文件中添加AWS相关私有变量（这些变量仅在服务端可见，不会暴露给客户端）：

AWS_ACCESS_KEY_ID=你的AWS密钥ID
AWS_SECRET_ACCESS_KEY=你的AWS密钥
AWS_REGION=你的S3存储桶区域（例如us-east-1）

2. 手动传递凭证给S3Client #

AWS SDK不会自动识别SvelteKit的env对象，需要手动提取凭证参数并传入S3Client的配置项：

import { S3Client } from '@aws-sdk/client-s3';
import { env } from '$env/dynamic/private';

// 仅在服务端代码中使用（如+server.js、+page.server.js、服务端钩子）
const s3Client = new S3Client({
  region: env.AWS_REGION,
  credentials: {
    accessKeyId: env.AWS_ACCESS_KEY_ID,
    secretAccessKey: env.AWS_SECRET_ACCESS_KEY
  }
});

3. 环境注意事项 #

• 上述代码必须在服务端执行，$env/dynamic/private导出的变量不会被打包到客户端代码中，避免凭证泄露。如果需要客户端操作S3，必须通过服务端API代理实现。
• 若部署在AWS原生环境（如ECS、EC2、Lambda），可省略手动传递凭证，SDK会自动从实例角色、环境变量等默认来源加载，此时只需传入区域参数即可：

import { S3Client } from '@aws-sdk/client-s3';
import { env } from '$env/dynamic/private';

const s3Client = new S3Client({
  region: env.AWS_REGION
});

原思路的问题说明 #

你之前尝试直接将env对象传给S3Client配置的方式是错误的——S3Client的配置结构中没有env这个参数，它需要的是credentials（包含密钥信息的对象）和region等特定字段，而非整个环境变量对象。

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