AWS S3 GetSignedUrl默认生成us-east-1区域URL 配置eu-west-3不生效问题

算力阿峰

2026-9-29

解决步骤

第一步先确认环境变量注入正确性
在初始化S3实例前添加打印语句，验证process.env.AWS_TRAININGS_BUCKET_REGION实际返回值是否为eu-west-3，如果该值为undefined，SDK会默认回退到us-east-1区域，这是最常见的触发原因。

第二步显式指定S3端点与路径样式
修改S3实例初始化配置，添加s3ForcePathStyle和endpoint参数，强制SDK使用指定区域的端点生成URL，避免虚拟主机寻址模式下的区域识别异常：

import AWS from 'aws-sdk';

// 先打印确认环境变量值
console.log('bucket region:', process.env.AWS_TRAININGS_BUCKET_REGION);

const s3 = new AWS.S3({
    region: process.env.AWS_TRAININGS_BUCKET_REGION,
    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
    signatureVersion: 'v4',
    s3ForcePathStyle: true, // 强制路径样式寻址
    endpoint: `s3.${process.env.AWS_TRAININGS_BUCKET_REGION}.amazonaws.com` // 显式绑定区域端点
});

第三步（可选）适配桶实际区域动态生成
如果存在桶区域和配置可能不一致的场景，可以先调用接口查询桶的实际所属区域，再生成签名URL：

export const getUrlS3 = async (fileKey) => {
    const { LocationConstraint } = await s3.getBucketLocation({ 
        Bucket: process.env.AWS_TRAININGS_BUCKET_NAME 
    }).promise();
    const actualRegion = LocationConstraint || 'us-east-1';
    const regionS3 = new AWS.S3({
        region: actualRegion,
        accessKeyId: process.env.AWS_ACCESS_KEY_ID,
        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
        signatureVersion: 'v4'
    });
    const getUrlParams = {
        Key: fileKey,
        Bucket: process.env.AWS_TRAININGS_BUCKET_NAME,
        Expires: 60*5
    }
    return regionS3.getSignedUrl('getObject', getUrlParams);
}