Firebase模拟器部署Firestore/Storage规则时出现‘Path segment cannot be empty’错误

错误信息 #

⚠  Unexpected rules runtime error: java.lang.IllegalArgumentException: Path segment cannot be empty
    at com.google.common.base.Preconditions.checkArgument(Preconditions.java:151)
    at com.google.firebase.rules.runtime.utils.PathUtils.parse(PathUtils.java:129)
    ...
Error: Failed to send Cloud Storage rules request due to rules runtime not available.
error Command failed with exit code 1.

同时伴随 Error: read EIO 错误。

配置文件详情 #

firebase.json #

{  
  "firestore": {    
    "rules": "firestore.rules",    
    "indexes": "firestore.indexes.json"  
  },  
  "functions": {    
    "predeploy": "npm --prefix \"$RESOURCE_DIR\" run build",    
    "source": "functions",    
    "runtime": "nodejs20"  
  },  
  "emulators": {    
    "auth": {      
      "port": 9099    
    },    
    "firestore": {      
      "port": 8080    
    },    
    "functions": {      
      "port": 5003    
    },    
    "storage": {      
      "port": 9199    
    },    
    "ui": {      
      "enabled": true,      
      "port": 4000    
    },    
    "singleProjectMode": true  
  },  
  "storage": {    
    "rules": "storage.rules"  
  }
}

firestore.rules #

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /partners/{partnerID}/documents/{documentID} {
      allow read: if request.auth != null;
    }

    function canAccessPartner(partnerID) {
      return partnerID in request.auth.token.partners;
    }

    match /partners/{partnerID} {
      allow get, update: if canAccessPartner(partnerID);
    }
    
    // other rules...
  }
}

storage.rules #

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

问题场景 #

启动Node.js后端并配合前端测试时触发上述错误，错误抛出时无法定位空路径的具体来源；同时出现Error: read EIO错误，疑似与Node.js或模拟器的IO交互有关。

已尝试的解决方法 #

• 验证Firestore和Storage规则中的路径段均无空值
• 重新安装node_modules并清理npm缓存
• 切换测试Node.js v18（LTS）和v20版本
• 启用模拟器详细日志，但未找到触发错误的具体请求

问题分析与解决方案 #

1. 规则配置的潜在排查点 #

你的规则语法本身没有明显的空路径问题，但需注意：

• Firestore规则中/partners/{partnerID}和/partners/{partnerID}/documents/{documentID}是独立的匹配分支，需确认后端/前端发起请求时，是否存在动态生成路径时变量为空的情况（比如partnerID或documentID未赋值，导致路径出现/partners//documents/xxx这类空段）。
• 用规则校验工具确认语法合法性：

  firebase firestore:rules:lint firestore.rules
  firebase storage:rules:lint storage.rules
  

2. 模拟器与依赖版本兼容性 #

• 检查Firebase CLI版本，建议升级到最新稳定版（npm install -g firebase-tools@latest），部分旧版本CLI与Node.js v20存在兼容性问题，可能导致规则运行时异常。
• 若升级CLI后问题依旧，可尝试回退到Node.js v18 LTS的稳定小版本（如v18.18.0），避免使用过于前沿的Node.js版本。

3. 定位空路径的触发源 #

• 开启模拟器的调试级日志，启动时添加--debug参数：

  firebase emulators:start --debug
  

  日志中会打印所有请求的详细路径，可直接定位到触发空路径错误的请求。
• 检查后端代码中Firestore/Storage的请求逻辑：比如拼接文档路径、存储文件路径时，是否存在变量未初始化、接口返回空值的情况，导致生成包含空段的路径。

4. 解决read EIO关联错误 #

该错误属于文件系统IO异常，可尝试：

• 清理Firebase模拟器缓存目录：
  • macOS/Linux: 删除~/.cache/firebase/emulators
  • Windows: 删除%APPDATA%\Roaming\firebase\emulators
• 确认模拟器使用的临时目录具备读写权限，避免权限不足导致IO失败。
• 检查端口占用情况，确保配置的模拟器端口（9099/8080/5003/9199/4000）未被其他程序占用，可临时更换端口测试。

5. 模拟器规则加载的验证 #

尝试单独加载规则到模拟器，排除部署环节的问题：

firebase emulators:start --only firestore,storage --import ./emulator-data

（若没有本地导入数据，可省略--import参数）

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