SageMaker Studio挂载自定义EFS后无法写入，求解决方法

问题现象 #

按AWS官方文档操作在JupyterLab中成功挂载自定义EFS，可查看custom-file-systems/efs/fs-0913ccfbff134d519路径内容，但写入（如创建笔记本）时提示：

Permission denied: custom-file-systems/efs/fs-0913ccfbff134d519/Untitled.ipynb

已完成配置 #

• 为EFS文件系统配置了包含elasticfilesystem:ClientMount、elasticfilesystem:ClientWrite、elasticfilesystem:ClientRootAccess的策略
• 为SageMaker用户角色配置了对应EFS访问的IAM策略

推测原因 #

1. 文件系统处于只读模式
2. 缺少POSIX权限，需通过访问点解决

疑问 #

• 推测是否正确？
• 为何按官方文档操作仍出现问题？
• 如何在SageMaker Studio挂载EFS访问点？

推测验证 #

你的两点推测完全正确，这是SageMaker挂载自定义EFS时最常见的权限问题根源：

1. 只读模式问题：即使IAM权限配置了写入，若EFS挂载时默认指定了只读参数，会直接触发写入失败
2. POSIX权限问题：SageMaker Studio容器以sagemaker-user用户（UID/GID通常为1000）运行，若EFS根目录的POSIX权限未开放给该用户/组，即使IAM权限允许，也会触发系统级权限拒绝

为何按官方文档操作仍出问题 #

官方文档仅覆盖了IAM权限和基础挂载流程，未明确说明两个关键细节：

• 挂载时需显式指定读写模式，否则部分场景会默认以只读方式挂载
• 未配置访问点时，EFS根目录默认POSIX权限（通常为root:root 700）会阻止sagemaker-user写入

具体解决步骤 #

步骤1：确认并修正EFS挂载模式 #

在JupyterLab终端执行以下命令查看挂载参数：

mount | grep fs-0913ccfbff134d519

若输出包含ro（只读标识），需重新挂载为读写模式：

sudo umount /custom-file-systems/efs/fs-0913ccfbff134d519
sudo mount -t efs fs-0913ccfbff134d519:/ /custom-file-systems/efs/fs-0913ccfbff134d519 -o rw

步骤2：通过EFS访问点解决POSIX权限问题（长期推荐方案） #

访问点可预配置POSIX权限，避免手动修改目录权限，操作如下：

1. 创建EFS访问点：
   • 在EFS控制台新建访问点，指定根目录路径（如/sagemaker-studio，不存在会自动创建）
   • 设置所有者UID/GID为1000:1000（对应SageMaker的sagemaker-user）
   • 设置目录权限为755或775
2. 在SageMaker Studio挂载访问点：
   • 打开JupyterLab终端，执行挂载命令：

     sudo mkdir -p /custom-file-systems/efs/fs-0913ccfbff134d519-ap
     sudo mount -t efs fs-0913ccfbff134d519:/ap-xxxxxxxxxxxx /custom-file-systems/efs/fs-0913ccfbff134d519-ap -o rw
     

     其中ap-xxxxxxxxxxxx是你的访问点ID
3. 验证权限：在挂载的访问点路径创建文件，确认无权限错误

步骤3：临时解决方案（直接修改EFS根目录POSIX权限） #

若不想创建访问点，可临时修改EFS根目录权限：

sudo chown 1000:1000 /custom-file-systems/efs/fs-0913ccfbff134d519
sudo chmod 755 /custom-file-systems/efs/fs-0913ccfbff134d519

注意：此方法仅临时生效，若EFS重新挂载需重复操作，长期场景优先使用访问点方案

内容的提问来源于stack exchange，提问作者Liang Ping Koh