使用AWS SDK生成Signed URL时遇TypeScript类型错误求助

核心问题原因 #

类型错误本质是AWS SDK的类型定义与Cloudflare R2的特殊配置（如region: 'auto'）存在兼容性冲突，加上环境变量的隐式undefined导致命令参数类型推断异常，最终触发ESLint的unsafe类型检查规则。

解决步骤 #

1. 确保依赖版本完全一致 #

@aws-sdk/client-s3和@aws-sdk/s3-request-presigner的版本必须严格匹配，版本不一致会导致类型定义不兼容。检查package.json，确保两者版本号相同，示例：

{
  "@aws-sdk/client-s3": "^3.422.0",
  "@aws-sdk/s3-request-presigner": "^3.422.0"
}

2. 修复S3Client配置的类型兼容性 #

给region添加字面量类型断言，避免TypeScript将其推断为宽泛的string类型，匹配SDK的类型约束：

const s3Client = new S3Client({
    region: 'auto' as const, // 断言为字面量类型
    endpoint: `https://${process.env.R2_ACCOUNT_ID!}.r2.cloudflarestorage.com`,
    credentials: {
        accessKeyId: process.env.R2_ACCESS_KEY!,
        secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
    },
});

3. 显式约束命令输入类型 #

明确GetObjectCommand的输入参数类型，同时用!断言环境变量非空（需确保运行时环境变量已正确配置）：

import { S3Client, GetObjectCommand, type GetObjectCommandInput } from '@aws-sdk/client-s3';

// ...

export async function getDownloadUrl(fileName: string): Promise<string> {
    const commandInput: GetObjectCommandInput = {
        Bucket: process.env.R2_BUCKET_NAME!,
        Key: fileName,
    };
    const command = new GetObjectCommand(commandInput);
    // ...
}

4. 安全验证预签名参数 #

用satisfies关键字替代类型断言，更安全地验证expiresIn参数符合RequestPresigningArguments类型要求：

import { getSignedUrl, type RequestPresigningArguments } from '@aws-sdk/s3-request-presigner';

// ...

const signedUrl = await getSignedUrl(
    s3Client,
    command,
    { expiresIn: 3600 } satisfies RequestPresigningArguments
);

完整修改后的代码 #

import { S3Client, GetObjectCommand, type GetObjectCommandInput } from '@aws-sdk/client-s3';
import { getSignedUrl, type RequestPresigningArguments } from '@aws-sdk/s3-request-presigner';

const s3Client = new S3Client({
    region: 'auto' as const,
    endpoint: `https://${process.env.R2_ACCOUNT_ID!}.r2.cloudflarestorage.com`,
    credentials: {
        accessKeyId: process.env.R2_ACCESS_KEY!,
        secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!,
    },
});

export async function getDownloadUrl(fileName: string): Promise<string> {
    const commandInput: GetObjectCommandInput = {
        Bucket: process.env.R2_BUCKET_NAME!,
        Key: fileName,
    };
    const command = new GetObjectCommand(commandInput);

    return await getSignedUrl(
        s3Client,
        command,
        { expiresIn: 3600 } satisfies RequestPresigningArguments
    );
}

额外排查点 #

如果仍有ESLint错误，可检查项目的@typescript-eslint配置：

• 确认是否过度启用了no-unsafe-assignment和no-unsafe-call规则
• 若需临时绕过，可在错误行添加注释：// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment（优先从类型根源解决，不推荐长期使用该方式）

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