Laravel挂载GCS Bucket至public目录后可写不可读问题求助

• 检查Web服务器进程的访问权限
  SSH能操作文件不代表Web服务器有权读取，先确认Web服务器的运行用户：

  • 针对nginx：执行ps aux | grep nginx查看worker进程的用户（通常是www-data、nginx或apache）
  • 挂载时直接指定权限参数，确保Web服务器用户能读取文件：
    gcsfuse --file-mode=755 --dir-mode=755 your-bucket-name /path/to/laravel/public/mountedimgdir
    这两个参数强制设置文件和目录的读写权限，避免因权限不足导致访问失败。

• 确认Web服务器根目录与挂载路径映射
  确保Web服务器的根目录确实指向Laravel的public目录，比如nginx配置中的root /path/to/laravel/public;。如果挂载的是符号链接，部分Web服务器需要开启符号链接跟随选项，比如在nginx配置中添加：

  location /mountedimgdir {
      follow_symlinks on;
  }
  

• 验证静态文件处理配置
  以nginx为例，默认配置中的try_files $uri $uri/ /index.php?$query_string;会优先查找静态文件。如果访问返回403，大概率是权限问题；如果返回404，先通过ls -l /path/to/laravel/public/mountedimgdir/img.png确认物理路径下文件是否真实存在。

• 统一挂载用户与Web服务器用户
  若挂载操作使用root用户，挂载目录的所有权可能为root:root，导致Web服务器用户无读取权限。挂载时直接指定Web服务器的UID和GID：
  gcsfuse --uid=$(id -u www-data) --gid=$(id -g www-data) your-bucket-name /path/to/laravel/public/mountedimgdir
  这样挂载后的文件所有权会与Web服务器用户一致，直接解决权限冲突问题。

• 本地测试定位错误类型
  在服务器上执行curl http://localhost/mountedimgdir/img.png测试访问，根据返回的错误码排查：

  • 403：回到权限设置步骤检查
  • 404：核对URL路径与物理文件路径是否匹配
  • 500：检查Laravel路由是否误拦截了静态文件请求

内容的提问来源于stack exchange，提问作者Justinus Amadia Wijaya