Laravel 9容器部署Cloud Run时数据库驱动缺失问题求助

核心原因 #

这个错误本质是你的Docker镜像里缺少PHP的MySQL PDO驱动——Laravel连接数据库依赖这个扩展，而默认的PHP基础镜像（比如php:fpm）通常不会预装它。

修复步骤 #

1. 修改Dockerfile，安装MySQL驱动 #

在构建镜像的过程中，添加安装pdo_mysql扩展的命令，以下是两种常见镜像的配置示例：

基于Debian的PHP镜像（如php:8.1-fpm）

FROM php:8.1-fpm

# 安装依赖并编译MySQL PDO驱动
RUN apt-get update && apt-get install -y \
    libmysqlclient-dev \
    && docker-php-ext-install pdo_mysql

# 后续Laravel部署步骤（复制代码、安装依赖等）
COPY . /var/www/html
RUN composer install --no-dev --optimize-autoloader

基于Alpine的轻量PHP镜像（如php:8.1-fpm-alpine）

FROM php:8.1-fpm-alpine

# 安装MySQL客户端和驱动
RUN apk add --no-cache mysql-client \
    && docker-php-ext-install pdo_mysql

2. 确认Laravel数据库配置适配Cloud Run #

确保你的环境变量（或.env文件）配置符合Cloud Run的Unix Socket连接模式：

DB_CONNECTION=mysql
DB_DATABASE=你的数据库名称
DB_USERNAME=${DB_USERNAME}
DB_PASSWORD=${DB_PASSWORD}
# Cloud Run的Unix Socket路径格式：/cloudsql/项目ID:区域:SQL实例名
DB_SOCKET=/cloudsql/your-project-id:us-central1:your-sql-instance

同时检查config/database.php中的mysql连接配置，确保包含：

'unix_socket' => env('DB_SOCKET', ''),

3. 给Cloud Run服务账号加权限 #

Cloud Run需要通过服务账号访问Cloud SQL实例，确保该账号拥有Cloud SQL Client角色：

• 进入Google Cloud控制台 → IAM与admin → IAM
• 找到Cloud Run对应的服务账号（格式为service-<项目编号>@serverless-robot-prod.iam.gserviceaccount.com）
• 为其添加「Cloud SQL Client」角色

4. 重新构建部署镜像 #

修改Dockerfile后，重新构建镜像并推送到容器仓库，再更新Cloud Run服务：

# 构建镜像
docker build -t gcr.io/your-project-id/laravel-app:v2 .

# 推送镜像到Google Artifact Registry/GCR
docker push gcr.io/your-project-id/laravel-app:v2

# 更新Cloud Run服务
gcloud run deploy laravel-app --image gcr.io/your-project-id/laravel-app:v2 --update-env-vars DB_USERNAME=xxx,DB_PASSWORD=xxx,DB_SOCKET=/cloudsql/xxx

额外检查点 #

• 确认Cloud SQL实例处于运行状态，且已经创建了Laravel所需的数据库
• 本地测试镜像：启动容器后，进入容器执行php artisan tinker，输入DB::connection()->getPdo()验证连接是否正常
• 查看Cloud Run日志：进入服务页面的日志面板，搜索"driver"相关关键词，排查是否有其他配置遗漏

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