单元测试Firebase Storage安全规则时遇"Not Implemented"错误如何解决？

问题根源 #

你在初始化测试环境时犯了个关键错误：把Storage的规则配置到了Firestore的配置项里，导致测试环境根本没正确加载Storage的安全规则，直接触发了未实现的错误。

修复步骤 #

1. 修正测试环境初始化配置
   把initializeTestEnvironment里的firestore字段换成storage，将Storage规则、本地模拟器的host和port都放到storage配置下。

2. 修正后的完整测试代码

import {
  assertFails,
  assertSucceeds,
  initializeTestEnvironment,
  RulesTestEnvironment,
} from "@firebase/rules-unit-testing";
import {
  deleteObject,
  ref,
  uploadBytes,
} from "firebase/storage";
import * as fs from "fs";
const PROJECT_ID = "iurn-973d0";
let testEnv: RulesTestEnvironment;

describe("Firebase storage security rules", () => {
  beforeAll(async () => {
    testEnv = await initializeTestEnvironment({
      projectId: PROJECT_ID,
      // 替换为storage配置项
      storage: {
        rules: fs.readFileSync(__dirname + "/../storage.rules", "utf-8"),
        host: "127.0.0.1",
        port: 9199,
      },
    });
  });
  beforeEach(async () => {
    if(!testEnv) return
    await testEnv.clearStorage(); // 异步方法必须加await
  });

  it("DOES NOT allow deletion", async () => {
    if(!testEnv) return
    const storage = testEnv.authenticatedContext("user123").storage();
    await testEnv.withSecurityRulesDisabled(async (context) => {
      // 用fs读取文件buffer替代require，避免类型不匹配
      const fileBuffer = fs.readFileSync("../assets/images/placeholder.png");
      await uploadBytes(ref(context.storage(), "hi.jpg"), fileBuffer)
    })
    await expect(assertFails(deleteObject(ref(storage, "hi.jpg")))).resolves.toBeDefined();
  })

  afterAll(async () => {
    if(!testEnv) return
    await testEnv.cleanup();
  });
});

额外注意事项 #

• testEnv.clearStorage()是异步操作，必须添加await，否则会导致测试数据清理不及时，影响后续测试。
• uploadBytes的第二个参数需传入Blob/File或Buffer类型，用fs.readFileSync读取文件buffer比require加载图片更稳妥。
• 确保本地Firebase Storage模拟器已启动（端口9199为默认模拟器端口）。

内容的提问来源于stack exchange，提问作者woop de schwoop