如何使用Node.js安全且便捷地连接Cloud SQL？

首推Cloud SQL Auth代理，它能彻底简化连接流程，同时解决SSL证书管理、IP白名单配置这些安全痛点，不管是本地开发还是生产部署都适用。

为什么选Auth代理？ #

• 自动处理加密连接，无需手动下载和维护SSL证书
• 无需配置IP白名单，通过Google Cloud身份验证机制建立安全连接，不用开放数据库公网端口
• 本地与生产环境连接方式统一，减少环境差异带来的配置麻烦

本地开发操作步骤 #

1. 启动Cloud SQL Auth代理
   下载对应系统的代理程序后，执行命令：

   ./cloud-sql-proxy 你的项目ID:地域:实例名称
   

   本地代理默认会把数据库端口转发到127.0.0.1的对应端口（PostgreSQL用5432，MySQL用3306）。

2. Node.js连接代码示例

   PostgreSQL（使用pg库） #

   const { Client } = require('pg');
   
   const dbClient = new Client({
     user: '数据库用户名',
     password: '数据库密码',
     database: '目标数据库名',
     host: '127.0.0.1',
     port: 5432
   });
   
   dbClient.connect()
     .then(() => console.log('数据库连接成功'))
     .catch(err => console.error('连接失败:', err));
   

   MySQL（使用mysql2库） #

   const mysql = require('mysql2/promise');
   
   async function initDBConnection() {
     try {
       const connection = await mysql.createConnection({
         host: '127.0.0.1',
         user: '数据库用户名',
         password: '数据库密码',
         database: '目标数据库名',
         port: 3306
       });
       console.log('数据库连接成功');
       return connection;
     } catch (err) {
       console.error('连接失败:', err);
       throw err;
     }
   }
   
   initDBConnection();
   

生产环境（GCP托管服务） #

部署在Cloud Run、GCE、GKE等GCP服务时，无需手动启动代理，直接利用内置集成：

• Cloud Run部署：部署时添加Cloud SQL实例连接，代码中使用Unix套接字路径作为host：

  const { Client } = require('pg');
  
   const dbClient = new Client({
     user: '数据库用户名',
     password: '数据库密码',
     database: '目标数据库名',
     host: '/cloudsql/你的项目ID:地域:实例名称'
   });
  

• 确保服务账号拥有Cloud SQL Client角色，自动完成身份验证，无需额外配置证书或IP规则。

关键注意事项 #

• 权限配置：本地开发用个人GCP账号（通过gcloud auth login验证），生产服务用服务账号，都需要Cloud SQL Client权限
• 依赖版本：使用最新版的数据库驱动（pg、mysql2等），确保对Unix套接字和代理连接的支持
• 避免硬编码：敏感信息（用户名、密码）建议用环境变量管理，不要直接写在代码里

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