通过gcsfuse挂载GCS Bucket到Compute Engine后无法直接创建文件怎么办

问题原因 #

该报错是gcsfuse的POSIX语义兼容性和编辑器默认写入逻辑冲突导致的：vi、mcedit这类编辑器新建文件时会默认先生成临时交换/备份文件，再通过重命名、同步操作写入最终文件，而gcsfuse默认配置下对这类原子操作的适配和本地磁盘存在差异，同时权限参数配置缺失也会触发该问题。

解决方案 #

1. 调整挂载参数 #

新增文件/目录权限配置，确保操作的用户有对应路径的读写权限，更新后的挂载命令如下：

• 临时挂载命令：
  gcsfuse --implicit-dirs --file-mode=0644 --dir-mode=0755 production-xxx-appspot /mount
• 持久化挂载命令：
  sudo mount -t gcsfuse -o implicit_dirs,allow_other,uid=1000,gid=1000,file_mode=0644,dir_mode=0755,key_file=service-account.json production-xxx-appspot /mount

如果仍存在元数据缓存不一致导致的路径识别问题，可以在挂载参数中追加stat_cache_ttl=0,type_cache_ttl=0关闭本地缓存（会小幅降低访问性能）。

2. 关闭编辑器的临时文件逻辑 #

编辑器默认生成的交换/备份文件是触发报错的核心原因，可以针对性关闭：

• vi/vim临时解决：编辑时添加-n参数跳过交换文件生成，例：vi -n /mount/files/a.txt
• vi/vim永久生效：在当前用户的~/.vimrc配置文件中添加set noswapfile
• mcedit：在设置页关闭「创建备份文件」「创建交换文件」选项即可。

验证方法 #

调整配置后先执行echo "test content" > /mount/files/a.txt测试直接写入是否正常，若该操作成功则确认是编辑器配置问题，若仍报错再排查挂载权限、服务账号的GCS读写权限是否正常。

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