AWS EC2 Windows实例启动/重启后UserData无法执行问题排查

核心原因 #

你的问题本质是自定义AMI未正确配置EC2 Windows Launch Agent的初始化环境，具体分三点：

1. Launch Agent任务计划未预设：创建AMI时，源实例的EC2 Launch Agent开机触发任务被禁用或未配置，导致新实例启动时不会自动执行UserData解析和运行逻辑，必须手动调用InitializeInstance.ps1 –Schedule重新注册任务计划。
2. 旧版Launch Agent不支持标签：如果源实例的EC2 Launch工具版本过旧，无法识别<persist>、<runAsLocalSystem>这类扩展标签，解析失败后会中断UserData读取流程，进而抛出“元数据为空”的错误（实际元数据存在，但解析失败后流程终止）。
3. Sysprep未正确保留EC2配置：手动执行Sysprep而非使用AWS官方脚本时，可能误删了EC2 Launch Agent的服务、任务计划或元数据缓存，导致新实例无法正常读取和处理UserData。

解决方法 #

一、重新制作正确的自定义AMI #

1. 更新EC2 Launch工具到最新版
   在源实例上运行PowerShell命令：

   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\UpdateEc2Launch.ps1
   

2. 重置Launch Agent初始化状态
   运行以下命令注册开机任务计划，但不立即执行（避免源实例的UserData影响新实例）：

   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule -NoExecution
   

3. 使用AWS官方Sysprep脚本
   不要手动运行Sysprep，执行AWS提供的脚本确保保留EC2相关配置：

   C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SysprepInstance.ps1
   

4. 创建新AMI
   等待Sysprep完成后停止实例，在AWS控制台创建新的自定义AMI。

二、临时解决现有实例的UserData执行问题 #

如果不想重新制作AMI，可在Terraform中添加remote-exec provisioner，自动触发初始化脚本：

resource "aws_instance" "windows_instance" {
  # 你的实例基础配置...
  user_data = <<-EOF
    <persist>true</persist>
    <runAsLocalSystem>true</runAsLocalSystem>
    # 你的PowerShell脚本内容
  EOF

  provisioner "remote-exec" {
    inline = [
      "C:\\ProgramData\\Amazon\\EC2-Windows\\Launch\\Scripts\\InitializeInstance.ps1 –Schedule"
    ]

    connection {
      type     = "winrm"
      user     = "Administrator"
      password = self.password
    }
  }
}

三、验证AMI正确性 #

创建新实例后，检查以下内容确认配置正常：

• 查看C:\ProgramData\Amazon\EC2-Windows\Launch\Log\UserdataExecution.log，无标签解析错误
• 确认任务计划中存在EC2Launch相关任务，且状态为“就绪”
• 自动执行的PowerShell脚本输出正常出现在日志中

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