Google Cloud SQL 连接失败与 HTTP 服务未启动的常见误区

本文解析 go 应用中因遗漏 `http.listenandserve` 导致的“bad http response”错误，并纠正 cloud sql 连接写法，帮助开发者区分 http 服务启动与数据库连接两类关键问题。

在使用 go 部署 Web 服务并连接 google Cloud SQL 时，初学者常将 HTTP 服务器未启动误判为数据库驱动异常。你遇到的错误：

the runtime process gave a bad HTTP response: '' ... net/http.func·011() ... panic serving 127.0.0.1:50091: Default addr for network '173.194.106.126:3306' unknown

并非来自 mysql 驱动或 Cloud SQL 配置问题，而是 Go 的 net/http 包在没有调用 http.ListenAndServe 的情况下，试图响应请求时触发的底层 panic —— 此时 HTTP 服务器根本未启动，所有入站请求（如本地 curl http://localhost:8080/）都会导致运行时崩溃。

✅ 正确的程序入口结构

Go 的 HTTP 服务必须显式启动。init() 函数仅注册路由，不启动服务器。你需要一个 main() 函数来启动监听：

package main // 注意：应为 package main，而非 package hello（app Engine 标准环境要求）  import (     "fmt"     "net/http"     "database/sql"     _ "github.com/go-sql-driver/mysql" )  func handler(w http.ResponseWriter, r *http.Request) {     const dbUserName = "userName"     const dbPassword = "password"     const dbIP = "123.123.231.123" // ⚠️ 实际应替换为 Cloud SQL 实例的公网 IP 或私有 IP（推荐 VPC 内网）      // ✅ 正确的 DSN 格式（含参数，提升健壮性）     dsn := fmt.Sprintf("%s:%s@tcp(%s:3306)/user?parseTime=true&loc=UTC",          dbUserName, dbPassword, dbIP)      db, err := sql.Open("mysql", dsn)     if err != nil {         http.Error(w, "DB connection failed: "+err.Error(), http.StatusInternalServerError)         return     }     defer db.Close() // ✅ defer 应在函数内尽早声明，确保关闭      // 测试连接（重要！sql.Open 不立即建连）     if err := db.Ping(); err != nil {         http.Error(w, "DB ping failed: "+err.Error(), http.StatusInternalServerError)         return     }      rows, err := db.Query("SELECT id, name FROM user LIMIT 5")     if err != nil {         http.Error(w, "Query failed: "+err.Error(), http.StatusInternalServerError)         return     }     defer rows.Close()      fmt.Fprintf(w, "Success! Retrieved %d rows.", countRows(rows)) }  func countRows(rows *sql.Rows) int {     count := 0     for rows.Next() {         count++     }     return count }  func main() {     http.HandleFunc("/", handler)     fmt.Println("Server starting on :8080...")     // ✅ 必须调用 ListenAndServe 启动 HTTP 服务     if err := http.ListenAndServe(":8080", nil); err != nil {         panic("Failed to start server: " + err.Error())     } }

⚠️ 关键注意事项

• package main 是必需的：App Engine（尤其是标准环境）和大多数 Go Web 部署平台要求主程序包名为 main。
• defer db.Close() 位置很重要：应放在 sql.Open 之后、函数返回前，避免因提前 panic 导致连接泄漏；但更推荐在 handler 结束前统一关闭（如上所示）。
• Cloud SQL 连接方式建议：
  • 若部署在 Google App Engine 标准环境，请改用 Unix socket 连接（无需公网 IP），格式为：
    user:password@unix(/cloudsql/YOUR_PROJECT:REGION:INSTANCE_NAME)/database
  • 若使用 Compute Engine 或外部网络，请确保 Cloud SQL 实例已启用公网 IP，且对应 IP 已添加至授权网络列表。
• 永远调用 db.Ping()：sql.Open 仅验证 DSN 语法，不建立真实连接；Ping() 才真正测试连通性与凭据有效性。
• 错误处理不可 panic：Web handler 中 panic 会终止整个 HTTP server；应使用 http.Error() 返回友好状态码。

总结

“bad HTTP response” 错误本质是 HTTP 服务缺失，与 Cloud SQL 驱动无关。修复核心仅两点：
① 补全 func main() 并调用 http.ListenAndServe；
② 使用正确 DSN + db.Ping() + 合理错误响应。
完成这两步后，再排查网络策略、权限配置或防火墙规则，才能高效定位真正的数据库连接问题。