本地托管Supabase文件上传报错：文件系统不支持扩展属性

问题根源 #

报错信息明确指出：文件系统不支持扩展属性（xattrs）或该功能被禁用，而Supabase Storage依赖xattrs处理文件元数据，这就是上传失败的核心原因。

具体修复方案 #

1. 开启文件系统的扩展属性支持 #

• Linux（ext4文件系统）：
  编辑/etc/fstab，给对应挂载分区加上user_xattr选项：

  /dev/sdXn /mnt/data ext4 defaults,user_xattr 0 2
  

  重新挂载分区生效：

  sudo mount -o remount /mnt/data
  

  验证是否开启成功：

  tune2fs -l /dev/sdXn | grep "Default mount options"
  

  输出里要能看到user_xattr。

• macOS：
  APFS默认支持xattrs，若被禁用，执行命令重启后生效：

  sudo defaults write /Library/Preferences/com.apple.fs.apfs EnableExtendedAttributes -bool true
  

• Windows（WSL2环境）：
  在/etc/wsl.conf里添加配置：

  [automount]
  options = "metadata,user_xattr"
  

  关闭并重启WSL：

  wsl --shutdown
  

2. 修改Supabase配置跳过xattrs检查 #

如果没法开启文件系统的xattrs，直接修改Storage服务配置禁用该依赖：

• 找到Supabase目录下的storage/config.toml文件
• 添加或修改以下配置：

  [storage]
  disable_xattr = true
  

• 重启Supabase服务：

  supabase restart
  

3. 验证修复 #

重新上传Australia.pmtiles文件，确认500错误不再出现。

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