使用Python AWS CDK创建HttpApi时遇Constructs版本冲突求助

问题背景 #

需求是通过Lambda向浏览器返回HTML内容，使用Python AWS CDK定义基础设施。最初思路是将Lambda通过HttpLambdaIntegration关联到HttpApi路由，但安装依赖时遇到版本冲突：

• aws-cdk-lib 2.56.1 依赖 constructs <11.0.0 且 >=10.0.0
• aws-cdk-aws-apigatewayv2-alpha 2.56.1a0 依赖 constructs <11.0.0 且 >=10.0.0
• aws-cdk-aws-apigatewayv2-integrations 1.184.1 依赖 constructs <4.0.0 且 >=3.3.69

用户转用TypeScript并通过npm --force强制安装才成功，疑惑是否用错包或思路有误，认为Python AWS CDK示例少、易出问题。

核心问题：依赖包版本不匹配 #

你混用了CDK v1风格的集成包和CDK v2的核心包/alpha包。CDK v2中，API Gateway v2的集成包并非独立的aws-cdk-aws-apigatewayv2-integrations，而是属于alpha阶段的aws-cdk.aws-apigatewayv2-integrations-alpha，且所有CDK相关包必须保持版本一致。

正确实现方案 #

1. 安装匹配版本的依赖 #

确保所有包版本与aws-cdk-lib一致，执行以下命令：

pip install aws-cdk-lib==2.56.1 constructs==10.0.0 aws-cdk.aws-apigatewayv2-alpha==2.56.1a0 aws-cdk.aws-apigatewayv2-integrations-alpha==2.56.1a0

2. 完整代码示例 #

包含Lambda定义、集成关联、HttpApi路由配置，以及Lambda返回HTML的逻辑：

from aws_cdk import Stack, Duration
from aws_cdk.aws_lambda import Function, Runtime, Code
from aws_cdk.aws_apigatewayv2_alpha import HttpApi, HttpMethod
from aws_cdk.aws_apigatewayv2_integrations_alpha import HttpLambdaIntegration
from constructs import Construct

class HtmlLambdaStack(Stack):
    def __init__(self, scope: Construct, construct_id: str, **kwargs) -> None:
        super().__init__(scope, construct_id, **kwargs)

        # 定义返回HTML的Lambda函数
        html_lambda = Function(
            self, "HtmlReturnLambda",
            runtime=Runtime.PYTHON_3_9,
            handler="index.handler",
            code=Code.from_inline("""
def handler(event, context):
    return {
        "statusCode": 200,
        "headers": {
            "Content-Type": "text/html"
        },
        "body": "<html><body><h1>Hello from Lambda!</h1><p>This is HTML content delivered via Python CDK.</p></body></html>"
    }
            """),
            timeout=Duration.seconds(10)
        )

        # 创建Lambda与HttpApi的集成
        lambda_integration = HttpLambdaIntegration("HtmlLambdaIntegration", html_lambda)

        # 创建HttpApi并绑定路由
        http_api = HttpApi(self, "HtmlHttpApi")
        http_api.add_routes(
            path="/",
            methods=[HttpMethod.GET],
            integration=lambda_integration
        )

3. 关键注意事项 #

• 所有CDK包（包括alpha包）必须版本完全匹配，避免依赖冲突。
• Lambda返回HTML时，必须在响应头中设置Content-Type: text/html，否则浏览器会将内容解析为纯文本。
• API Gateway v2的部分功能在CDK v2中仍处于alpha阶段，需使用带-alpha后缀的包。

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