Docker化NextCloud迁移后遇内部服务器错误及数据库死锁问题求助

1. 检查并修复数据库引擎与事务隔离级别 #

• 先确认NextCloud数据库所有表是否使用InnoDB引擎（MyISAM不支持事务，易引发死锁）：

  SELECT TABLE_NAME, ENGINE FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = '你的NextCloud数据库名';
  

  若存在MyISAM表，执行转换命令：

  ALTER TABLE 表名 ENGINE=InnoDB;
  

• 将数据库事务隔离级别改为READ COMMITTED（NextCloud官方推荐，可降低死锁概率）：
  在MySQL/MariaDB配置文件（如/etc/mysql/my.cnf或/etc/mysql/mariadb.conf.d/50-server.cnf）中添加：

  transaction-isolation = READ-COMMITTED
  

  重启数据库服务：sudo systemctl restart mysql

2. 修复文件锁定机制 #

• 临时禁用文件锁定，避免现有锁阻塞操作：
  在NextCloud的config/config.php中添加或修改：

  'filelocking.enabled' => false,
  

• 执行数据库索引与字段修复命令：

  docker exec -it 你的NextCloud容器名 php occ db:add-missing-indices
  docker exec -it 你的NextCloud容器名 php occ db:convert-filecache-bigint
  

• 重新启用文件锁定，并配置Redis/Memcached作为锁后端（比数据库锁更稳定）：
  将config.php中filelocking.enabled改回true，同时添加Redis配置示例：

  'memcache.distributed' => '\OC\Memcache\Redis',
  'memcache.locking' => '\OC\Memcache\Redis',
  'redis' => [
      'host' => 'redis容器名/IP',
      'port' => 6379,
      'password' => '',
      'timeout' => 0.0,
  ],
  

3. 清理死锁残留与重置客户端认证 #

• 手动清理数据库中过期的锁定条目：

  DELETE FROM oc_file_locks WHERE lock_timeout < UNIX_TIMESTAMP();
  

• 登录NextCloud后台，进入「个人设置」→「安全」，删除对应同步客户端的会话记录，之后重新在客户端登录认证。

4. 调整Docker资源与数据库连接参数 #

• 给NextCloud和数据库容器分配足够资源，避免资源不足导致事务超时：
  在docker-compose.yml中调整资源限制：

  services:
    nextcloud:
      deploy:
        resources:
          limits:
            cpus: '2.0'
            memory: 4G
    db:
      deploy:
        resources:
          limits:
            cpus: '1.0'
            memory: 2G
  

• 优化数据库连接配置，在config.php中添加：

  'dboptions' => [
      1002 => 'SET wait_timeout = 600',
      PDO::ATTR_PERSISTENT => true,
  ],
  

5. 验证修复效果 #

• 重启所有Docker容器：docker-compose down && docker-compose up -d
• 查看NextCloud日志确认死锁报错消失：docker exec -it 你的NextCloud容器名 cat data/nextcloud.log
• 测试同步客户端，重新登录并尝试文件同步。

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