如何通过AWS CloudFront实现S3多版本文件夹的Latest访问配置

要实现你需要的功能，S3静态网站托管的静态重定向规则确实做不到——因为它无法动态计算最新版本。你需要借助CloudFront的动态路径改写能力，配合AWS服务来获取并替换最新版本。以下是两种可行方案，以及获取最新版本的具体方法：

一、获取S3中的最新版本文件夹 #

首先明确：S3没有真正的“文件夹”，只有对象前缀。假设你的版本文件夹格式是plugin-v1.2.3/、plugin-v2.0.0/这类语义化版本前缀，你可以通过以下方式提取最新版本：

方法1：CLI快速验证 #

用AWS CLI列出所有版本前缀，排序后取第一个：

aws s3 ls s3://your-bucket-name/ --prefix "plugin-v" --delimiter "/" | grep "PRE" | sort -r | head -1

这条命令会返回最新的版本文件夹（比如PRE plugin-v2.0.0/），你可以提取其中的版本号部分。

方法2：自动化获取（用于后续路由） #

推荐把最新版本号存到SSM参数存储，通过定时Lambda定期更新，这样路由逻辑可以直接读取参数，避免每次请求都遍历S3（提升性能、降低成本）。

创建一个定时Lambda函数（设置CloudWatch事件触发，比如每小时一次），代码示例：

const AWS = require('aws-sdk');
const s3 = new AWS.S3();
const ssm = new AWS.SSM();

exports.handler = async () => {
    const bucketName = 'your-bucket-name';
    // 列出所有版本前缀
    const listResult = await s3.listObjectsV2({
        Bucket: bucketName,
        Prefix: 'plugin-v', // 匹配你的版本前缀格式
        Delimiter: '/'
    }).promise();

    // 提取版本名并按语义化版本排序
    const versions = listResult.CommonPrefixes.map(item => item.Prefix.slice(0, -1)); // 去掉末尾的/
    const latestVersion = versions.sort((a, b) => {
        const aParts = a.split('.').map(part => parseInt(part.split('-v')[1] || part));
        const bParts = b.split('.').map(part => parseInt(part.split('-v')[1] || part));
        for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
            if (aParts[i] > bParts[i]) return -1;
            if (aParts[i] < bParts[i]) return 1;
        }
        return 0;
    })[0];

    // 更新SSM参数
    await ssm.putParameter({
        Name: '/plugin/latest-version',
        Value: latestVersion,
        Type: 'String',
        Overwrite: true
    }).promise();

    return { success: true, latestVersion };
};

给这个Lambda添加S3:ListBucket和SSM:PutParameter权限，确保能正常执行。

二、方案1：CloudFront Functions（推荐，低成本低延迟） #

CloudFront Functions是轻量级的边缘计算服务，适合简单的路径改写逻辑，成本远低于Lambda@Edge。

步骤1：创建CloudFront函数 #

1. 打开CloudFront控制台，进入“函数”页面，点击“创建函数”
2. 选择“查看器请求”类型，输入函数名称后创建
3. 替换函数代码为：

async function handler(event) {
    const request = event.request;
    const uri = request.uri;

    // 检查路径是否包含/latest/
    if (uri.includes('/latest/')) {
        // 从SSM读取最新版本
        const ssm = require('aws-sdk/clients/ssm');
        const client = new ssm();
        const param = await client.getParameter({
            Name: '/plugin/latest-version',
            WithDecryption: false // 如果参数未加密，设为false
        }).promise();
        const latestVersion = param.Parameter.Value;

        // 替换路径中的/latest/为最新版本前缀
        request.uri = uri.replace('/latest/', `/${latestVersion}/`);
    }

    return request;
}

4. 给函数的服务角色添加ssm:GetParameter权限，确保能读取SSM参数
5. 发布函数版本

步骤2：关联到CloudFront分发 #

1. 打开你的CloudFront分发，进入“行为”标签
2. 编辑对应缓存行为（比如默认行为）
3. 在“函数关联”部分，“查看器请求”选择刚才创建的函数
4. 保存更改，等待CloudFront部署完成（通常需要几分钟）

三、方案2：Lambda@Edge（灵活适配复杂逻辑） #

如果你的版本规则更复杂（比如需要实时遍历S3获取最新版本，不依赖SSM），可以用Lambda@Edge：

步骤1：创建Lambda函数（必须在us-east-1区域） #

1. 打开Lambda控制台，选择us-east-1区域，创建函数
2. 替换代码为：

const AWS = require('aws-sdk');
const s3 = new AWS.S3();

exports.handler = async (event) => {
    const request = event.Records[0].cf.request;
    const uri = request.uri;

    if (uri.includes('/latest/')) {
        const bucketName = 'your-bucket-name';
        // 实时列出S3版本前缀
        const listResult = await s3.listObjectsV2({
            Bucket: bucketName,
            Prefix: 'plugin-v',
            Delimiter: '/'
        }).promise();

        // 排序获取最新版本
        const versions = listResult.CommonPrefixes.map(item => item.Prefix.slice(0, -1));
        const latestVersion = versions.sort((a, b) => {
            const aParts = a.split('.').map(part => parseInt(part.split('-v')[1] || part));
            const bParts = b.split('.').map(part => parseInt(part.split('-v')[1] || part));
            for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
                if (aParts[i] > bParts[i]) return -1;
                if (aParts[i] < bParts[i]) return 1;
            }
            return 0;
        })[0];

        // 替换路径
        request.uri = uri.replace('/latest/', `/${latestVersion}/`);
    }

    return request;
};

3. 给Lambda添加S3:ListBucket权限，发布函数版本

步骤2：关联到CloudFront分发 #

和CloudFront Functions的关联步骤一致，在CloudFront行为的“查看器请求”中选择发布的Lambda@Edge版本即可。

为什么之前S3静态网站重定向没生效？ #

S3静态网站的重定向规则是静态配置，只能基于固定的前缀或精确路径匹配跳转，无法动态计算最新版本——规则一旦设置就固定了，不能实时更新。所以必须用CloudFront的边缘计算能力来实现动态路径改写。

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