Docker部署下NextCloud无法连接MariaDB的问题排查求助

核心现象分析 #

从日志和配置来看，PhpMyAdmin能正常连接MariaDB，但NextCloud容器从IP 172.18.0.4 访问时，MariaDB持续返回Access denied for user 'nextcloud_rw'@'172.18.0.4'，说明问题出在NextCloud的连接配置或容器启动参数上。

可能的原因及对应解决步骤 #

1. 安装界面数据库凭据混淆 #

用户在NextCloud安装界面可能混淆了管理员账户和数据库账户：

• 管理员账户：用户名nextcloud、密码N3xtCl0ud!（这部分设置正确）
• 数据库配置区：需要填写数据库专用账户nextcloud_rw、密码N3xtCl0ud!，而非管理员用户名。

解决：
重新访问NextCloud安装界面，在数据库配置区域确保填写：

• 数据库类型：MySQL/MariaDB
• 数据库主机：db
• 数据库名：nextcloud
• 数据库用户：nextcloud_rw
• 数据库密码：N3xtCl0ud!

2. 容器启动命令中密码的特殊字符未转义（仅终端执行场景） #

如果通过bash终端执行docker run命令，密码中的!是bash历史扩展字符，未用单引号包裹会导致密码被错误解析。例如：
错误写法：-e MYSQL_PASSWORD=N3xtCl0ud!
正确写法：-e MYSQL_PASSWORD='N3xtCl0ud!'

解决：
停止并删除现有NextCloud容器，用修正后的命令重新创建：

docker stop nextcloud
docker rm nextcloud
docker run -d --name nextcloud --network nextcloud \
  -e MYSQL_HOST=db \
  -e MYSQL_DATABASE=nextcloud \
  -e MYSQL_USER=nextcloud_rw \
  -e MYSQL_PASSWORD='N3xtCl0ud!' \
  -v /volume1/docker/nextcloud:/var/www/html \
  --restart=unless-stopped -p 8080:80 nextcloud:latest

3. NextCloud容器多余挂载数据库卷 #

NextCloud启动命令中的-v db:/var/lib/mysql完全多余：NextCloud通过网络连接MariaDB，无需直接挂载数据库文件目录，该挂载可能引发潜在的目录权限冲突。

解决：
在重新创建NextCloud容器时，移除该参数（如上述修正后的命令所示）。

4. 数据库用户权限验证 #

虽然PhpMyAdmin能连接，但仍需确认nextcloud_rw用户的访问权限范围：

1. 登录PhpMyAdmin，进入「用户账户」页面
2. 找到nextcloud_rw用户，确认其主机设置为%（允许所有IP访问）
3. 确认该用户拥有nextcloud数据库的全部操作权限

若权限不符，修改后保存即可。

5. 数据库密码正确性验证 #

进入MariaDB容器，直接验证nextcloud_rw用户的密码：

docker exec -it mariadb mysql -u nextcloud_rw -pN3xtCl0ud! -D nextcloud

若能成功登录，说明密码正确；若登录失败，需重新创建MariaDB容器（确保密码用单引号包裹）。

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