Azure容器应用中Bitnami Moodle无法连接MariaDB问题排查

针对你在Azure Web App for Containers部署Bitnami Moodle+MariaDB容器时遇到的连接失败问题（报错ERROR 2002 (HY000): Can't connect to server on 'mariadb' (115)），结合本地/AWS正常运行的情况，重点排查Azure环境特有的差异点：

1. 容器启动就绪性问题 #

depends_on仅保证MariaDB容器先于Moodle启动，但不保证MariaDB服务完全初始化完成。Azure容器启动调度的延迟可能导致Moodle在数据库服务就绪前发起连接，触发超时错误。

解决方法：
在Moodle服务的配置中添加等待逻辑，确保MariaDB端口就绪后再启动Moodle服务。修改docker-compose.yml中moodle服务的command：

moodle:
  # 其他配置保持不变
  command: bash -c "until nc -z mariadb 3306; do sleep 2; done; /opt/bitnami/scripts/moodle/run.sh"

Bitnami官方镜像默认包含nc工具，若缺失可通过apt-get install netcat提前安装。

2. MariaDB网络绑定限制 #

部分场景下，MariaDB可能默认绑定127.0.0.1导致容器外无法访问，虽然Bitnami镜像默认配置为0.0.0.0，但Azure环境可能存在隐性配置覆盖。

解决方法：
在mariadb服务的环境变量中显式指定绑定地址：

mariadb:
  # 其他配置保持不变
  environment:
    # 原有环境变量保留
    - MARIADB_BIND_ADDRESS=0.0.0.0

3. Azure存储卷权限冲突 #

Azure Web App for Containers的本地卷（local driver）权限模型与本地/AWS存在差异，Bitnami镜像依赖特定用户（如bitnami）读写数据卷，权限异常会导致MariaDB初始化失败。

解决方法：

• 先移除volumes配置，测试无持久化存储时是否能正常启动，验证是否为卷权限问题；
• 若需持久化，可尝试将卷权限调整为bitnami用户可读写，或在mariadb服务中保留BITNAMI_DEBUG=true查看初始化日志，定位权限报错细节。

4. Azure应用设置覆盖环境变量 #

Azure Web App的「应用设置」中若存在与docker-compose.yml同名的环境变量，会优先覆盖容器配置，导致数据库连接参数错误。

解决方法：
登录Azure门户，进入Web App -> 配置 -> 应用设置，检查是否存在MARIADB_PASSWORD、MOODLE_DATABASE_PASSWORD等同名变量，确保参数与docker-compose一致，或直接在应用设置中统一配置所有必要变量。

5. 容器资源配额不足 #

Azure Web App for Containers默认资源配额较低，若CPU/内存不足，MariaDB初始化过程会超时，导致Moodle连接失败。

解决方法：
进入Azure门户，Web App -> 配置 -> 常规设置，提升容器的CPU和内存配额（例如设置为1核CPU、2GB内存），再重新部署测试。

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