[BUG]: Error: SQLite database error

快速结论：此报错通常发生在 Docker 部署 AnythingLLM 首次启动时，容器因无法写入 SQLite 数据库文件而崩溃。优先排查宿主机上存储目录 $HOME/anythingllm 的权限设置，特别是目录属主是否与 Docker 容器内运行的用户一致。

问题场景

用户在 Linux/macOS 主机上通过 Docker 运行 AnythingLLM，使用 docker run 或 docker compose 启动容器时立即崩溃，Docker 日志显示 SQLite 数据库只读或无法打开。

报错原文

Error: SQLite database error
attempt to write a readonly database
   0: sql_schema_connector::sql_migration_persistence::initialize
           with namespaces=None
             at schema-engine/connectors/sql-schema-connector/src/sql_migration_persistence.rs:14
   1: schema_core::state::ApplyMigrations
             at schema-engine/core/src/state.rs:201

另一种常见变体：

Error: Schema engine error:
SQLite database error
unable to open database file: ../storage/anythingllm.db

原因分析

可能原因如下（根据 Issue 评论整理）：

文件权限问题（最常见）：宿主机上的 $HOME/anythingllm 目录及其下的 .env 文件、anythingllm.db 数据库文件缺少容器的写入权限。Docker 容器通常以非 root 用户（UID 1000）运行，如果目录由 root 创建，容器内进程无法写入。
数据库被锁定：同时运行多个 AnythingLLM 容器实例，或使用 DB Browser for SQLite 等外部工具打开了数据库文件，导致文件被锁定，变成只读。
安装方式引起的权限错位：以 root 用户运行安装脚本后，目录属主为 root，但 Docker 容器内用户不是 root（例如 Oracle Cloud 上的 opc 用户），导致权限冲突。

环境排查

宿主机操作系统（Linux 发行版及版本，例如 Ubuntu 24）
Docker 版本
是否以 root 或非 root 用户运行 Docker 命令
宿主机上 $HOME/anythingllm 目录的当前权限和属主（通过 ls -la $HOME/anythingllm 查看）
是否同时运行多个 AnythingLLM 容器
是否有其他进程打开了 anythingllm.db 文件

解决步骤

确保目录具有正确权限（可优先尝试）：
- 临时方案：给目录和 .env 文件授予 777 权限：chmod -R 777 $HOME/anythingllm 以及 chmod 777 $HOME/anythingllm/.env。此方法已验证可解决问题，但不推荐长期使用。
- 推荐方案：将目录属主改为容器内运行的用户。大多数情况下 Docker 容器以 UID 1000（第一个非 root 用户）运行，执行：sudo chown -R 1000:1000 $HOME/anythingllm。
- 在 Oracle Cloud 等环境，用户为 opc：sudo chown -R opc:opc $HOME/anythingllm。
检查是否有多个容器同时运行：停止其他 AnythingLLM 容器，确保只有一个实例访问数据库。
避免外部工具锁定数据库：关闭 DB Browser for SQLite 或其他可能打开 anythingllm.db 的程序。
重新启动容器：docker restart <container_name> 或重新运行启动命令。