Angular集成Firebase Storage模拟器上传视频报错，文件大小异常求助

在Angular应用中使用Firebase Storage/Hosting/Auth模拟器实现文件上传功能，图片上传正常，但上传视频等大文件时出现以下错误：

FirebaseError: Firebase Storage: An unknown error occurred, please check the error payload for server response. (storage/unknown)

模板代码：

<input type="file" (change)="onFileChange($event)" />

业务代码：

constructor(private storage: AngularFireStorage)

onFileChange(fileChangeEvent: Event) {    
    const target = fileChangeEvent.target as HTMLInputElement;
    const file = (target.files as FileList)[0];
    const filePath = file.name;
    const fileRef = this.storage.ref(filePath);
    const task = fileRef.put(file);
}

Storage规则：

rules_version = '2';
service firebase.storage {
    match /b/{bucket}/o {
        match /{allPaths=**} {
            allow read, write: if request.auth!=null;
        }
    }
}

尝试上传视频后，Storage模拟器中会生成一个文件，但文件大小始终为262.14 kB，类型为application/octet-stream。请问这是什么原因？

核心原因 #

这是Firebase Storage模拟器的分片上传限制导致的：
Firebase Storage处理大文件时默认启用分片上传，但本地模拟器对分片拼接的支持有限。当文件超过默认分片阈值（约256KB，和你看到的262.14KB匹配）时，模拟器无法完成后续分片的合并，只保留了第一块分片数据，因此文件大小固定且类型被识别为通用的application/octet-stream。另外代码未添加错误监听，无法获取更详细的失败信息，进一步阻碍排查。

解决办法 #

1. 调整模拟器分片上传配置 #

通过修改模拟器配置，强制大文件使用单块上传（仅适用于开发环境）：

• 方法一：启动模拟器时添加环境变量

  FIREBASE_STORAGE_EMULATOR_UPLOAD_MAX_CHUNK_SIZE=10485760 firebase emulators:start
  

  （上述设置为10MB，可根据你的文件大小自行调整）

• 方法二：在firebase.json中配置

  {
    "emulators": {
      "storage": {
        "port": 9199,
        "uploadMaxChunkSize": 10485760
      }
    }
  }
  

2. 完善代码的元数据与错误处理 #

显式指定文件元数据并添加错误监听，确保文件类型正确并排查潜在问题：

onFileChange(fileChangeEvent: Event) {    
    const target = fileChangeEvent.target as HTMLInputElement;
    const file = (target.files as FileList)[0];
    const filePath = file.name;
    const fileRef = this.storage.ref(filePath);
    
    // 显式设置文件元数据，保证类型识别正确
    const metadata = {
        contentType: file.type
    };
    
    const task = fileRef.put(file, metadata);
    
    // 添加错误监听，获取详细报错信息
    task.catch(error => {
        console.error('上传错误详情:', error);
    });
}

3. 临时验证Auth规则（可选） #

如果模拟器中Auth状态存在异常，也可能导致上传中断。可临时放宽Storage规则，验证是否为Auth相关问题：

rules_version = '2';
service firebase.storage {
    match /b/{bucket}/o {
        match /{allPaths=**} {
            allow read, write: if true; // 测试完成后恢复原规则
        }
    }
}

额外提示 #

• 本地模拟器仅用于基础功能测试，大文件上传的完整逻辑建议在Firebase生产环境的测试项目中验证，模拟器的分片上传支持存在天然局限性。
• 确保你的AngularFire和Firebase CLI版本为最新，旧版本模拟器可能存在已知的大文件上传bug。

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