部署Next.js-Strapi v4至GCP App Engine时，连接Cloud SQL PostgreSQL遭遇connect ENOENT错误求助

阿华AIGC实验室

2026-4-23

看起来你已经做了不少基础配置工作，但还是卡在了Unix套接字连接的问题上，我来帮你一步步排查和解决这个问题：

1. 先确认INSTANCE_CONNECTION_NAME的准确性

你需要确保app.yaml里的<INSTANCE_CONNECTION_NAME>是完全正确的，格式必须是[项目ID]:[区域]:[实例名称]，这个值可以直接在Cloud SQL实例的概览页面复制粘贴，注意别带多余的空格或者符号，很多时候拼写错误是这类问题的元凶。

2. 修正Strapi数据库配置的细节

你当前的database.js写法方向是对的，但有几个小细节要注意：

确认环境变量INSTANCE_CONNECTION_NAME已经在app.yaml里正确替换成真实值，而不是保留占位符<INSTANCE_CONNECTION_NAME>
对于PostgreSQL的Unix套接字连接，你可以尝试显式添加socketPath参数（虽然host路径理论上也能识别，但有时候Strapi的PostgreSQL客户端需要明确指定），修改后的配置如下：

module.exports = ({ env }) => ({
  connection: {
    client: "postgres",
    connection: {
      socketPath: `/cloudsql/${env('INSTANCE_CONNECTION_NAME')}`,
      database: env("DATABASE_NAME", "strapi"),
      user: env("DATABASE_USERNAME", ""),
      password: env("DATABASE_PASSWORD", ""),
      port: env.int("DATABASE_PORT", 5432),
    },
  },
});

3. 验证App Engine服务账号的权限生效

你提到给App Engine默认服务账号加了Cloud SQL Client角色，这没问题，但要确认：

服务账号的格式是[你的项目ID]@appspot.gserviceaccount.com，别选错了账号
权限绑定后需要等待1-2分钟生效，有时候刚加完权限立刻部署会因为缓存导致权限未生效

4. 本地连接错误的解决思路

你本地连接也遇到同样的错误是正常的，因为本地环境没有GCP的Unix套接字路径/cloudsql/...，本地测试需要用Cloud SQL Auth Proxy：

下载对应系统的Cloud SQL Auth Proxy
运行命令：./cloud-sql-proxy [你的INSTANCE_CONNECTION_NAME]
修改本地database.js的host为127.0.0.1，再启动Strapi就能正常连接了

5. 检查App Engine配置的YAML语法

YAML对缩进非常敏感，确认app.yaml里的beta_settings缩进是正确的（用空格，别用tab），正确的格式应该是：

runtime: nodejs16
instance_class: F2
env_variables:
  NODE_ENV: 'production'
  INSTANCE_CONNECTION_NAME: '你的真实实例连接名'
  DATABASE_NAME: '你的数据库名'
  DATABASE_USERNAME: '你的数据库用户名'
  DATABASE_PASSWORD: '你的数据库密码'
beta_settings:
  cloud_sql_instances: '你的真实实例连接名'

另外，建议把数据库的用户名、密码等敏感信息也通过env_variables配置，避免硬编码在代码里。