获取EC2实例区域：EC2MetadataUtils的合规替代方案咨询

之前很多人误用了internal包下的EC2MetadataUtils，这个类从包路径就能看出来属于SDK内部实现，确实没有兼容性承诺，生产环境不要依赖。官方公开支持的稳定实现有以下几种：

• 使用AWS SDK for Java 2.x 公开的IMDS（实例元数据服务）客户端
  这是最推荐的SDK原生方案，相关类都属于公开稳定API，版本迭代会保持向后兼容，默认支持IMDSv2安全要求，示例代码：

  // 引入对应依赖：software.amazon.awssdk:imds
  try (Ec2MetadataClient metadataClient = Ec2MetadataClient.create()) {
      InstanceIdentityDocument identityDoc = metadataClient.get(
          Ec2MetadataPath.INSTANCE_IDENTITY_DOCUMENT_RESPONSE,
          InstanceIdentityDocument.class
      );
      String instanceRegion = identityDoc.region();
  }
  

  用try-with-resources管理客户端生命周期即可，不需要额外配置，运行在EC2环境下会自动适配网络和权限。

• 直接调用本地元数据HTTP端点解析
  如果不想引入额外SDK依赖，可以直接请求EC2本地固定的元数据服务端点获取信息，这个端点的行为AWS有长期稳定承诺，返回结构不会做不兼容变更：

  1. 先获取IMDSv2鉴权Token（所有2019年之后推出的EC2实例默认强制要求IMDSv2）
  2. 携带Token请求实例身份文档接口，解析返回JSON中的region字段即可
     对应的命令行参考：

  # 获取有效期6小时的访问Token
  METADATA_TOKEN=$(curl -s -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600")
  # 拉取身份信息
  curl -s -H "X-aws-ec2-metadata-token: $METADATA_TOKEN" http://169.254.169.254/latest/dynamic/instance-identity/document
  

  自己实现简单的HTTP请求和JSON解析就能完成逻辑，完全不依赖SDK内部类。

• 启动阶段静态注入区域信息
  如果实例是通过自动化脚本、IaC工具（CloudFormation/Terraform等）、AutoScaling组启动的，可以在实例启动阶段直接把区域信息写入环境变量或者本地配置文件，业务运行时直接读取即可，不需要运行时调用元数据服务，稳定性最高。

提示：所有SDK路径中包含internal的类、方法都属于非公开API，不管看起来多好用都不要在生产代码里直接依赖，这些实现可能在任何版本的补丁更新里被修改、删除，且不会提前做兼容性通知，很容易引发线上故障。

内容的提问来源于stack exchange，提问作者Suganthan Madhavan Pillai