使用AWS Lambda实现vanity URL跳转遇CloudFront错误求助

一、核心预期偏差：301重定向无法实现带掩码跳转 #

你要的带掩码跳转（地址栏保留原vanity URL），本质是让用户浏览器显示原URL，但加载目标页面的内容。而当前代码返回的301是永久重定向，会直接让浏览器跳转到目标URL，地址栏必然改变，这和你的预期完全不符，这是第一个需要修正的逻辑问题。

二、当前代码的格式错误（导致CloudFront报错） #

CloudFront对Lambda@Edge返回的响应格式有严格要求，你的代码存在以下问题：

• headers中location数组的对象结构缺少规范要求的type字段；
• 若要返回301重定向，需确保Location头的value是完整合法的URL。

修正后的301重定向代码（仅用于普通跳转，非带掩码）：

import json

def lambda_handler(event, context):
    response = {
        'status': '301',
        'statusDescription': 'Moved Permanently',
        'headers': {
            'location': [{
                'key': 'Location',
                'value': 'https://cf-distribution/page/',
                'type': 'response'
            }]
        }
    }
    return response

三、实现带掩码跳转的正确方案 #

要实现地址栏保留原vanity URL、实际加载目标页面的效果，需要返回一个包含iframe的HTML页面，模拟GoDaddy的带掩码跳转逻辑：

import json

def lambda_handler(event, context):
    target_url = "https://cf-distribution/page/"
    # 生成包含iframe的HTML内容，实现掩码跳转
    html_content = f'''<!DOCTYPE html>
<html>
<head>
    <title>Redirecting...</title>
    <style>
        body, html {{ margin: 0; padding: 0; height: 100%; overflow: hidden; }}
        iframe {{ width: 100%; height: 100%; border: none; }}
    </style>
</head>
<body>
    <iframe src="{target_url}" frameborder="0"></iframe>
    <!-- 备用：如果iframe加载失败，用JS跳转 -->
    <script>
        if (!document.querySelector('iframe').contentWindow) {{
            window.location.href = "{target_url}";
        }}
    </script>
</body>
</html>'''
    
    response = {
        'status': '200',
        'statusDescription': 'OK',
        'headers': {
            'content-type': [{
                'key': 'Content-Type',
                'value': 'text/html; charset=utf-8',
                'type': 'response'
            }],
            'cache-control': [{
                'key': 'Cache-Control',
                'value': 'no-cache, no-store, must-revalidate',
                'type': 'response'
            }]
        },
        'body': html_content,
        'bodyEncoding': 'text'
    }
    return response

四、其他可能导致报错的排查点 #

• Lambda@Edge权限：确保Lambda函数的执行角色拥有lambda.amazonaws.com和edgelambda.amazonaws.com的信任关系，且已被复制到CloudFront边缘区域（部署后AWS会自动复制，可在Lambda控制台"Versions"中查看）；
• CloudFront配置：确认Viewer Request事件已正确关联该Lambda函数，且使用的是已发布的函数版本（不能用$LATEST版本）；
• HTTPS配置：确保vanity URL已在CloudFront中配置为自定义域名，关联了us-east-1区域ACM颁发的有效SSL证书，且分发已启用HTTPS。

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