基于Lando的Drupal项目执行rebuild/start时出现镜像清单未知错误

AI 小北

2026-6-12

解决Lando Drupal项目中MySQL镜像找不到的问题

问题场景

基于Lando的Drupal本地开发项目，配置文件如下：

lando.base.yml

Services:
database:
    type: mysql:8.4
    creds:
      user: drupal
      password: xxx
      database: drupal
    authentication: caching_sha2_password
    config:
      database: local/mysql.cnf

lando.yml

name: someproject
services:
  appserver:
    overrides:
      environment:
        DRUSH_OPTIONS_URI: "https://someproj.lndo.site"

执行lando rebuild或lando start时，出现错误：

manifest for bitnami/mysql:8.0.39-debian-12-r5 not found: manifest unknown: manifest unknown

尝试在lando.yml中直接指定MySQL包未成功，Lando仍查找该无效镜像。

解决方案

直接指定可用的Bitnami MySQL镜像标签
Lando默认映射的MySQL版本对应的镜像可能已被Bitnami移除，需手动指定当前存在的8.4系列镜像标签。修改lando.base.yml的database服务，添加image字段：
```
Services:
database:
    type: mysql:8.4
    image: bitnami/mysql:8.4.0-debian-12-r10 # 替换为当前可用的8.4版本标签
    creds:
      user: drupal
      password: xxx
      database: drupal
    authentication: caching_sha2_password
    config:
      database: local/mysql.cnf
```
可通过本地Docker命令docker search bitnami/mysql --filter=is-official=false查看可用标签。
清理Lando缓存与本地Docker镜像
执行命令清理旧缓存和无效镜像引用：
```
lando cache clear
docker system prune -f
```
完成后重新执行lando rebuild。
临时降级MySQL版本
若8.4版本的镜像问题持续，可暂时切换到更稳定的8.0版本，修改lando.base.yml中的type字段：
```
Services:
database:
    type: mysql:8.0
    creds:
      user: drupal
      password: xxx
      database: drupal
    authentication: caching_sha2_password
    config:
      database: local/mysql.cnf
```
Lando对8.0版本的镜像映射更成熟，不易出现镜像缺失问题。