boto3等待EC2实例就绪的正确方式及send_command偶发bug排查

1. instance.wait_until_running() #

这是EC2实例对象的专属方法，仅作用于当前实例。它只检查实例的生命周期状态，等实例从pending变为running就会返回。此时实例本身已经启动，但操作系统可能还在初始化，SSM Agent这类依赖服务大概率还没就绪，无法响应send_command()。

2. ec2.get_waiter('instance_running').wait(InstanceIds=[instance.id]) #

这是AWS SDK提供的通用等待器，通过EC2客户端调用。它和上面的wait_until_running()逻辑完全一致，都是等待实例生命周期状态到running。区别在于这个方法支持一次性传入多个实例ID，批量等待实例启动，而前者只能针对单个实例对象。

3. ec2.get_waiter('instance_status_ok').wait(InstanceIds=[instance.id]) #

这个等待器的检查条件严格得多：它会等EC2的系统状态检查和实例状态检查全部通过。

• 系统状态检查：AWS层面验证实例的硬件、网络连接是否正常；
• 实例状态检查：验证实例内部的操作系统是否正常运行，SSM Agent是否已启动并能和AWS SSM服务通信。
  只有这两项都通过，等待器才会返回，此时实例才算真正“完全就绪”。

send_command()依赖SSM Agent正常运行并完成AWS注册，只等实例进入running状态远远不够——这就是你遇到偶发bug的核心原因：实例刚启动，但SSM Agent还没准备好接收命令。

正确的做法是等待实例状态检查通过，也就是使用instance_status_ok等待器。你可以直接用它，因为它会自动先等待实例进入running状态，再等待状态检查通过；也可以分步写，更清晰：

# 先确保实例启动
instance.wait_until_running()
# 再等待实例内部服务就绪
waiter = ec2.get_waiter('instance_status_ok')
waiter.wait(InstanceIds=[instance.id])

这样就能保证实例完全就绪，避免send_command()的偶发失败。

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