Firebase Functions部署报错：文件超2GB限制，求排查方向

关于报错中未显示具体文件的说明 #

当前报错信息没有直接指出超大文件的路径，原因是firebase-tools在计算源码目录哈希值的过程中，读取到了超过2GB的文件，直接抛出错误中断了后续的文件遍历流程，因此没能输出具体的文件路径。

排查思路 #

• 快速定位大文件：在项目的functions目录下执行命令扫描大于2GB的文件
  • macOS/Linux终端：find ./functions -type f -size +2G
  • Windows PowerShell：Get-ChildItem -Path .\functions -Recurse -File | Where-Object {$_.Length -gt 2GB}
• 检查意外生成的文件：
  • 排查是否有本地日志文件、程序dump文件、数据库备份文件误放入functions目录
  • 确认是否存在符号链接/快捷方式指向外部的大文件（报错提示明确提到需要移除这类链接）
  • 检查node_modules是否有异常超大包（虽然罕见，但不排除依赖包引入的问题）
• 核对部署目录配置：查看firebase.json中的functions.source字段，确认部署范围是否包含了非必要的上级目录或外部文件
• 清理缓存与临时文件：
  • 清除Firebase工具的本地缓存：firebase functions:clear-cache
  • 删除functions目录下的临时文件夹（如tmp）、日志输出文件等
• 逐步缩小排查范围：
  • 尝试将functions目录下的子文件夹逐个移出，每次执行部署测试，直到找到包含大文件的目录
  • 单独部署单个函数时，确保该函数对应的子目录下无超大文件，命令示例：firebase deploy --only functions:yourTargetFunction

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