Azure WebApp中Docker部署的Laravel无法从挂载存储提供图片

针对Azure WebApp自定义容器中软链接指向Azure文件存储无法正常返回图片的问题，可尝试以下步骤：

1. 确保Apache允许跟随软链接 #

检查Apache站点配置文件（通常在/etc/apache2/sites-enabled/目录下），为Laravel的public目录添加FollowSymLinks选项：

<Directory /var/www/api/public>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Require all granted
</Directory>

修改后重启Apache：service apache2 restart

2. 映射Azure存储权限到Apache运行用户 #

Azure文件存储挂载后默认权限为nobody:nogroup，而Apache通常以www-data用户运行，需确保Apache有读取权限：

• 挂载Azure存储时指定uid和gid（33是www-data的默认ID），挂载命令添加参数：

  -o uid=33,gid=33
  

  若通过Azure门户配置挂载，可在配置->路径映射的挂载选项中填入uid=33,gid=33

3. 调整Apache文件传输配置 #

除已设置的EnableSendfile off，再添加EnableMMAP off——Azure存储文件系统不支持内存映射，可能导致传输异常：

EnableSendfile off
EnableMMAP off

重启Apache使配置生效。

4. 确保软链接在容器启动后创建 #

不要在Docker镜像构建阶段创建软链接，而是在容器启动脚本（entrypoint）中执行创建命令，确保存储挂载完成后再生成软链接：

ln -fs /var/www/data_persistent/maps /var/www/api/public/maps

5. 用Laravel路由代理文件访问 #

若上述配置均无效，可绕过Apache静态文件处理，用Laravel路由直接返回存储文件：
在routes/web.php中添加路由：

Route::get('/maps/{path}', function ($path) {
    $filePath = sprintf('/var/www/data_persistent/maps/%s', $path);
    if (!file_exists($filePath) || !is_file($filePath)) {
        abort(404);
    }
    return response()->file($filePath);
})->where('path', '.*');

之后访问/maps/xxx.png时，Laravel会直接读取存储文件并返回响应。

内容的提问来源于stack exchange，提问作者sebastian.do