Docker部署Flask文件上传应用SQLite无数据问题求助

1. 数据库路径与容器持久化问题（最常见） #

本地用相对路径（比如sqlite:///app.db）时，数据存在项目目录，但Docker容器内的文件默认是临时的——容器重启或销毁后，数据直接消失。另外如果容器工作目录和本地不一致，数据库文件的位置也会错位。

• 排查：进入容器看指定路径下有没有数据库文件：docker exec -it <容器ID> ls -l <你的工作目录>
• 解决：用Docker卷挂载本地目录到容器内的数据库路径，比如启动命令加-v ./local_db:/app/db，同时把应用里的连接字符串改成sqlite:///db/app.db，这样数据会存在本地的local_db文件夹里，不会随容器消失。

2. 容器内文件权限不足 #

容器运行的用户可能没权限创建或写入数据库文件，导致操作看似成功（返回200）但实际没写入磁盘。

• 排查：进容器看目录权限：docker exec -it <容器ID> ls -ld <数据库所在目录>，再看运行用户：docker exec -it <容器ID> whoami
• 解决：在Dockerfile里提前创建目录并设置权限：

  RUN mkdir -p /app/db && chown -R appuser:appuser /app/db
  

  或者临时用root用户启动容器（生产环境别这么干）：docker run --user root ...

3. 数据库初始化逻辑没执行 #

本地可能手动跑过db.create_all()建表，但Docker部署时没自动触发，导致表根本没创建。

• 排查：看容器启动日志有没有初始化相关的报错：docker logs <容器ID>，再检查代码里db.create_all()是不是只在本地启动时执行。
• 解决：把初始化逻辑加到应用启动入口，比如：

  if __name__ == '__main__':
      db.create_all()
      app.run(host='0.0.0.0', port=5000)
  

  用工厂模式的话，确保创建app实例后立刻调用db.create_all()。

4. 镜像构建时覆盖了数据库文件 #

如果Dockerfile里用COPY把本地的空app.db复制到容器里，会把容器运行时生成的数据库文件覆盖掉。

• 排查：看Dockerfile里的COPY命令，有没有复制.db后缀的文件。
• 解决：在.dockerignore里加*.db，避免把本地数据库文件复制到镜像里。

5. 事务没提交 #

代码里插完数据没调用db.session.commit()，导致事务只在内存里，没写到磁盘上。

• 排查：检查数据插入的代码块，确认最后有没有提交事务。
• 解决：在插入完成后加db.session.commit()，或者用上下文管理器自动处理：

  with app.app_context():
      # 你的数据插入逻辑
      db.session.commit()
  

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