AWS EC2实例挂载S3桶异常求助：空目录/连接中止错误

一、前置必做检查 #

• 确认EC2实例的IAM角色已配置目标S3桶的对应权限，至少包含s3:ListBucket（列桶内容）和s3:GetObject/s3:PutObject（读写对象），权限资源需明确指定为arn:aws:s3:::XXXXXXXXXXX和arn:aws:s3:::XXXXXXXXXXX/*，避免使用过于宽泛的权限。
• 确保s3fs-fuse为较新版本（低于1.90建议更新）：
  • 亚马逊Linux 2：sudo amazon-linux-extras install epel -y && sudo yum install s3fs-fuse -y
  • Ubuntu/Debian：sudo apt update && sudo apt install s3fs-fuse -y
• 创建并设置挂载目录权限：sudo mkdir -p /s3_mount && sudo chmod 755 /s3_mount

二、手动挂载的正确操作（解决空目录问题） #

不要仅依赖挂载命令的成功提示，需添加调试和认证参数确保生效：

1. 卸载残留挂载（若存在）：sudo umount /s3_mount；若提示忙，改用sudo fusermount -u /s3_mount
2. 执行带调试参数的挂载命令：

sudo s3fs XXXXXXXXXXX /s3_mount -o iam_role=auto -o allow_other -o dbglevel=info -o curldbg

• -o iam_role=auto：自动读取EC2实例的IAM角色凭证，无需手动配置密钥
• -o allow_other：允许非root用户访问挂载目录（按需启用）
• -o dbglevel=info：输出调试日志，方便定位空目录原因

3. 挂载后验证：
   • 若目录仍为空，查看调试输出：若提示权限错误，检查IAM角色权限；若提示S3连接失败，确认EC2网络是否放行HTTPS（443端口）出站，私有子网需配置S3 VPC端点；若桶本身无内容，先上传测试文件再验证。

三、UserData中挂载的正确配置（解决连接中止问题） #

UserData执行时，EC2可能未完成网络初始化或IAM凭证加载，需添加等待逻辑和重试机制：

1. 示例UserData脚本（以亚马逊Linux 2为例）：

#!/bin/bash
# 等待IAM凭证就绪
until curl -s http://169.254.169.254/latest/meta-data/iam/security-credentials/ > /dev/null 2>&1; do
    echo "等待IAM凭证加载..."
    sleep 5
done

# 安装s3fs-fuse（未预装时执行）
sudo amazon-linux-extras install epel -y
sudo yum install -y s3fs-fuse

# 准备挂载目录
sudo mkdir -p /s3_mount
sudo chmod 755 /s3_mount

# 清理残留挂载
sudo umount /s3_mount > /dev/null 2>&1 || sudo fusermount -u /s3_mount > /dev/null 2>&1

# 挂载S3桶，添加重试机制
sudo s3fs XXXXXXXXXXX /s3_mount -o iam_role=auto -o allow_other -o retries=5

# 延迟验证（s3fs为异步挂载）
sleep 10
if ls /s3_mount > /dev/null 2>&1; then
    echo "挂载验证成功"
else
    echo "挂载验证失败，查看系统日志：/var/log/messages"
fi

2. 关键注意点：
   • 等待IAM凭证：通过元数据端点确认凭证加载完成，避免因认证失败导致连接问题
   • 重试参数-o retries=5：应对网络初始化阶段的临时连接中断
   • 延迟验证：s3fs挂载为异步操作，立即执行ls可能未完成连接

四、常见排障补充 #

• 若手动挂载后目录空，检查是否挂载时指定了-o prefix=xxx前缀限制，或S3桶本身无内容
• 私有子网环境下，必须配置S3 VPC端点，并确保路由表指向该端点，否则无法访问S3
• 禁止在挂载命令中硬编码AWS密钥，优先使用IAM角色，避免密钥泄露和权限冲突
• 若问题持续，查看系统日志：亚马逊Linux看/var/log/messages，Ubuntu看/var/log/syslog，里面会有s3fs的详细错误信息

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