AWS CDK Python：无法将SQS及其死信队列ARN存入SSM参数存储求助

常见问题排查与修正方案 #

1. 修正SSM参数构造ID

你代码里SSM参数的构造ID包含空格（"arn value of queue"），虽然CDK允许，但易引发潜在命名问题，建议改用规范标识符，比如"QueueArnParameter"。

2. 显式声明依赖（稳妥优化）

虽然CDK会自动处理资源依赖，但显式声明可确保队列创建完成后再生成SSM参数：

queue_param = ssm.StringParameter(self, "QueueArnParameter",
                    parameter_name="test",
                    string_value=self.sqs_queue.queue_arn)
queue_param.node.add_dependency(self.sqs_queue)

3. 检查参数名称冲突

若参数存储中已存在名为"test"的参数，且类型不匹配（比如是SecureString而非String）或无覆盖权限，会导致部署失败。建议修改参数名称为唯一值，或确保现有参数类型一致。

4. 验证部署权限

确认CDK部署使用的IAM角色拥有ssm:PutParameter权限。如果是默认CDK引导角色，通常包含该权限；若自定义了权限策略，需添加以下语句：

{
    "Effect": "Allow",
    "Action": "ssm:PutParameter",
    "Resource": "arn:aws:ssm:${AWS_REGION}:${AWS_ACCOUNT_ID}:parameter/test"
}

完整修正代码示例 #

from aws_cdk import (
    Stack,
    Duration,
    aws_sqs as sqs,
    aws_ssm as ssm
)
from constructs import Construct

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

        dead_letter_queue: sqs.Queue = sqs.Queue(
            self,
            id="DeadLetterQueue",
            queue_name="dlqueue",
            retention_period=Duration.days(14)
        )
        self.sqs_queue: sqs.Queue = sqs.Queue(
            self,
            id="SqsQueue",
            queue_name="queue",
            retention_period=Duration.days(4),
            visibility_timeout=Duration.hours(6),
            delivery_delay=Duration.seconds(0),
            receive_message_wait_time=Duration.seconds(0),
            max_message_size_bytes=262144,  # 256 KiB
            dead_letter_queue=sqs.DeadLetterQueue(
                max_receive_count=1,
                queue=dead_letter_queue
            )
        )

        # 修正后的SSM参数创建逻辑
        ssm.StringParameter(self, "QueueArnParameter",
                            parameter_name="test",
                            string_value=self.sqs_queue.queue_arn)

部署验证 #

执行cdk deploy后，登录AWS控制台进入Systems Manager > 参数存储，检查是否存在名为test的参数，其值为目标SQS队列的ARN即可。

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