Docker容器中Firebase Auth Emulator数据持久化导出目录异常排查

问题核心原因 #

1. 模拟器导出参数的默认行为：Firebase Auth模拟器的--export-on-exit参数并非直接将数据写入你指定的目录，而是会在该目录下生成一个带时间戳的firebase-export-<timestamp>子文件夹，这就是你看到的“随机命名文件夹”，属于模拟器的标准导出逻辑。
2. 信号处理无异常：你执行docker stop后能看到导出文件夹，说明firebase-tools已经正确捕获了SIGTERM信号并完成导出流程，信号处理不是问题所在，核心是对参数行为的误解。

解决方案 #

方案1：利用模拟器自动读取最新导出的特性 #

无需修改导出逻辑，只需调整启动时的导入参数——当--import指向包含多个导出子文件夹的目录时，模拟器会自动加载其中最新的导出数据。修改Dockerfile的ENTRYPOINT：

FROM node:lts-alpine
RUN apk add --no-cache openjdk17-jre-headless && \
npm install -g firebase-tools && mkdir data
COPY firebase.json ./
ENTRYPOINT ["firebase", "--project", "docker-emulator", "emulators:start", "--import=/data", "--export-on-exit=/data"]

启动后模拟器会自动加载/data下最新的firebase-export-<timestamp>文件夹，停止时会在/data下生成新的时间戳导出文件夹，实现数据持久化。

方案2：直接导出到/data根目录（无嵌套子文件夹） #

如果希望数据直接写入/data根目录，可通过自定义启动脚本实现：

1. 创建start-emulator.sh脚本：

#!/bin/sh
# 启动模拟器并后台运行
firebase --project docker-emulator emulators:start --import=/data --export-on-exit=/tmp/export &
PID=$!

# 捕获SIGTERM信号，等待模拟器完成导出
trap "kill -SIGTERM $PID; wait $PID" SIGTERM

# 等待模拟器退出，将临时导出目录的内容移动到/data
wait $PID
mv /tmp/export/firebase-export-*/* /data/

2. 修改Dockerfile：

FROM node:lts-alpine
RUN apk add --no-cache openjdk17-jre-headless && \
    npm install -g firebase-tools && mkdir -p /data /tmp/export
COPY firebase.json ./
COPY start-emulator.sh ./
RUN chmod +x start-emulator.sh
ENTRYPOINT ["./start-emulator.sh"]

该脚本会让模拟器先导出到临时目录，再将内容移动到/data根目录，完全符合你的预期。

额外检查 #

确认你的firebase.json没有覆盖导出路径的配置，示例配置如下：

{
  "emulators": {
    "auth": {
      "port": 9099
    },
    "ui": {
      "port": 4000
    }
  }
}

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