Azure App Service Linux容器中Strapi SQLite数据库持久化问题求助

你遇到的SQLITE_BUSY: database is locked错误是SQLite在Azure持久存储环境下的典型问题，核心原因和SQLite的单文件特性、Azure存储的文件系统锁支持以及容器配置细节有关。下面是几个针对性的解决方案：

1. 确认Strapi数据库路径指向持久化目录 #

首先检查你的Strapi数据库配置文件（config/database.js），确保数据库文件的存储路径完全匹配你在docker-compose中挂载的目录：

module.exports = ({ env }) => ({
  defaultConnection: 'default',
  connections: {
    default: {
      connector: 'bookshelf',
      settings: {
        client: 'sqlite',
        // 必须指向挂载的/cms/data目录下的数据库文件
        filename: '/cms/data/data.db',
      },
      options: {
        useNullAsDefault: true,
      },
    },
  },
});

如果路径不匹配，Strapi会在容器内部创建数据库文件，不仅无法持久化，还可能和挂载目录的文件产生访问冲突。

2. 限制SQLite连接池大小并延长超时 #

SQLite是单文件数据库，不支持多并发写操作，调整Strapi的数据库连接池配置，避免多个连接竞争锁资源：

// 在config/database.js的options中添加连接池配置
options: {
  useNullAsDefault: true,
  pool: {
    min: 1,
    max: 1, // 强制只使用1个连接，避免并发冲突
    acquireTimeoutMillis: 60000, // 延长获取连接的超时时间
    idleTimeoutMillis: 60000,
  },
},
// 在settings的options中增加SQLite自身的超时设置
settings: {
  client: 'sqlite',
  filename: '/cms/data/data.db',
  options: {
    timeout: 60000, // 让SQLite遇到锁时等待更长时间再抛出错误
  },
},

3. 调整Azure存储挂载的权限与参数 #

Azure App Service使用Azure Files作为持久存储，默认挂载配置可能缺少必要的POSIX锁支持或权限：

• 在Azure Portal的App Service容器设置中，找到存储挂载项，确保权限设为Read/Write，并添加挂载选项：dir_mode=0777,file_mode=0777,uid=1000,gid=1000（匹配容器内Strapi运行用户的UID/GID）
• 如果用Dockerfile构建镜像，建议提前创建目录并设置权限：

RUN mkdir -p /cms/data && chown -R node:node /cms/data

4. 禁用Strapi集群模式 #

如果Strapi启用了集群模式（生产环境默认可能开启），多个进程会同时访问SQLite文件导致锁冲突，需要强制禁用集群：

• 修改Dockerfile的启动命令，添加--no-cluster参数：

CMD ["npm", "start", "--", "--no-cluster"]

额外检查点 #

• 避免多实例部署：Azure App Service的持久存储是共享的，如果运行多个容器实例，多进程同时访问SQLite文件必然导致锁冲突——SQLite不适合多实例场景，若需要横向扩展，建议切换到PostgreSQL等支持多连接的数据库
• 清理残留日志文件：如果挂载目录下存在data.db-journal文件，手动删除它，这个临时日志文件有时会导致锁残留问题

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