ECS Fargate使用paperclip gem访问S3失败：无法连接169.254.169.254:80

1. 适配Fargate元数据服务端口差异 #

EC2的元数据服务端口是80，但Fargate使用的ECS任务元数据服务（V4版本默认端口8081，V3版本是80但地址为169.254.170.2）。旧版AWS SDK/Paperclip默认只会访问169.254.169.254:80，导致连接失败。需要手动配置元数据端点：

Aws.config.update(
  instance_profile_credentials: {
    endpoint: 'http://169.254.169.254:8081' # 对应Fargate V4元数据服务
  }
)

注意：根据Fargate平台版本调整端点，V3版本用http://169.254.170.2:80。

2. 确保Paperclip启用IAM角色访问 #

检查Paperclip配置中是否明确开启IAM角色凭证获取，避免硬编码密钥的残留逻辑干扰：

Paperclip::Attachment.default_options.merge!(
  storage: :s3,
  s3_credentials: {
    use_iam_profile: true,
    region: '你的区域'
  },
  s3_bucket: '你的存储桶名'
)

3. 验证Fargate任务元数据服务状态 #

在ECS任务定义中确认已启用任务元数据服务：

• Fargate平台版本1.4.0+默认启用V4版本；
• 旧版本需在任务定义的containerDefinitions中添加metadata配置，确保元数据服务正常运行。

4. 检查网络出站规则 #

Fargate任务所在的子网安全组需允许访问169.254.0.0/16网段（元数据服务所属网段），避免出站规则拦截本地元数据请求。

5. 升级依赖版本 #

旧版Paperclip或AWS SDK可能未适配Fargate环境，尝试升级到最新稳定版，优先选择支持Fargate元数据自动检测的SDK版本（如aws-sdk-s3 v1.100+）。

内容的提问来源于stack exchange，提问作者Avinash Kumar Singh