Azure App Service挂载AzureFile时Firefox/curl大文件下载失败

• Azure App Service（P1V2 计划）
• Docker Container 部署
• 容器基础镜像为php:7.4-apache，apache2、php配置均保持默认未修改
• 先后测试Standard、Premium层级Azure Storage Account，将AzureFile挂载到站点文档根目录的子目录下

• 通过Apache直接提供75MB文件下载时，Chrome可正常完成下载，Firefox、curl均下载失败
• 大小阈值验证：2MB文件可在Firefox正常下载，3MB及以上文件在Firefox下载失败；将相同75MB文件放在容器本地非挂载目录时，所有客户端均可正常下载
• curl执行下载报错输出：

curl http://example.com/install/TheSetup.exe --output TheSetup.exe
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  1 75.6M    1  988k    0     0  1937k      0  0:00:39 --:--:--  0:00:39 1937k
curl: (18) transfer closed with 78332760 bytes remaining to read

• Firefox侧报错：仅能下载部分文件内容，很快提示下载失败，报错截图：
  

Chrome可正常下载的核心原因是其默认启用多线程分块Range请求逻辑，会自动将大文件拆分为多个小于2MB的分片拉取，刚好避开Azure App Service挂载AzureFile时的单连接连续读取截断阈值；Firefox、curl默认采用单连接全量拉取模式，当单次连接连续读取挂载路径下的文件超过阈值时，会被App Service的存储挂载代理强制断开连接，触发传输中断报错。
该问题属于典型的静态服务与网络挂载存储适配问题：默认Apache配置开启了内核态sendfile传输机制，直接透传网络文件系统的文件句柄，没有用户态缓冲和中断重试逻辑，读取本地磁盘文件时无异常，读取网络挂载存储时就容易出现连接截断。该使用场景官方没有做专项兼容，需要手动调整配置适配。

按生效优先级排序操作：

1. 调整Apache核心配置，关闭内核态文件传输机制，开启用户态缓冲
   在Apache全局配置apache2.conf或对应站点的vhost配置中添加以下内容：

   EnableSendfile Off
   EnableMMAP Off
   <Directory "/var/www/html">
       OutputBuffering On
   </Directory>
   

   配置完成后执行service apache2 restart重启服务生效。该配置会让Apache读取文件时走用户态内存缓冲，不会直接在内核态透传网络文件系统的文件句柄，从根源上避免挂载层句柄异常断开导致的传输截断。
2. 开启Apache Range请求支持
   启用mod_headers模块，针对下载类文件添加响应头，支持客户端分块拉取：

   <FilesMatch "\.(exe|zip|msi|bin|dmg|apk)$">
       Header set Accept-Ranges "bytes"
   </FilesMatch>
   

3. 大文件下载最优实践
   不建议直接通过Apache静态文件服务对外提供Azure File挂载目录的大文件下载，可通过PHP实现下载代理逻辑，在代码层控制按2048KB分块读取文件输出，每读取一块刷新一次输出缓冲，同时设置正确的Content-Length、Content-Type响应头，这种方式可以完全规避挂载层的传输截断问题，兼容性最好。

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