如何用firebase-cli上传mapping.txt至Crashlytics？遇未知错误求排查

• 检查Java环境配置

  • 执行java -version和javac -version，确认本地安装的Java版本为8及以上（推荐11），且JDK而非JRE环境
  • 验证JAVA_HOME环境变量：Linux/macOS执行echo $JAVA_HOME，Windows执行echo %JAVA_HOME%，确保路径指向正确的JDK目录
  • 检查PATH变量：Linux/macOS执行which java，Windows执行where java，确认输出为JDK下的java可执行文件，而非系统默认的JRE

• 验证Crashlytics配置文件有效性

  • 确认crashlytics.xml路径正确、文件存在，且包含com.crashlytics.ApiKey和com.crashlytics.BuildSecret两个必填字段，值与Firebase控制台对应项目的信息完全一致
  • 用cat app/src/main/res/values/crashlytics.xml（Linux/macOS）或type app/src/main/res/values/crashlytics.xml（Windows）查看文件内容，确认XML格式无错误（标签闭合、特殊字符转义等）

• 检查Firebase CLI状态与权限

  • 升级CLI到最新版本：执行firebase tools:upgrade，旧版本可能存在Java调用的兼容性问题
  • 重新认证登录状态：执行firebase login --reauth，确保当前账号拥有目标项目的Crashlytics编辑权限
  • 执行firebase projects:list，确认目标APP ID对应的项目在列表中，且账号有权访问

• 手动模拟Java调用流程

  • 带--debug参数执行firebase crashlytics:mappingfile:generateid，在日志中查找CLI调用Java的完整命令（可能在输出深处），复制该命令单独执行，获取更详细的错误信息
  • 若找不到完整命令，可从Firebase控制台对应项目的Crashlytics设置中下载独立上传工具，执行类似命令测试：java -jar crashlytics-uploader.jar -apiKey=XXX -buildSecret=XXX -appId=[MY_APP_ID] mapping.txt

• 排查文件与路径问题

  • 确认mapping.txt存在且当前用户有读取权限：Linux/macOS执行ls -l mapping.txt，Windows执行dir mapping.txt
  • 避免路径含空格或特殊字符，将mapping.txt和crashlytics.xml移至临时目录，使用绝对路径执行命令，例如：

    firebase crashlytics:mappingfile:upload --app=[MY_APP_ID] \
        --resource-file=/Users/xxx/temp/crashlytics.xml \
        /Users/xxx/temp/mapping.txt
    

• 系统权限与环境排查

  • Linux/macOS下检查SELinux或AppArmor是否限制了Java进程的网络访问或文件读取权限
  • Windows下尝试以管理员身份运行命令提示符/PowerShell，避免权限不足导致的Java执行失败

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