Go语言中MySQL插入语句失效：语法正确仍报内部服务器错误

我之前也碰到过类似的问题，看起来语法没问题但就是插不进数据还返回500，大概率是错误处理不到位或者连接/配置环节出了疏漏，咱们一步步来梳理解决：

1. 补全数据库初始化的错误检查 #

你当前的initDB函数里，sql.Open只是创建了连接池对象，并没有真正和数据库建立连接，很多连接失败的问题会被延迟到执行SQL的时候才暴露，导致返回内部错误。必须加上db.Ping()来验证连接：

func initDB(){
    var err error
    // 替换成你的实际连接字符串，格式：user:password@tcp(host:port)/dbname
    db, err = sql.Open("mysql", "your_user:your_password@tcp(127.0.0.1:3306)/your_db")
    if err != nil {
        log.Fatalf("Failed to create DB connection pool: %v", err)
    }
    // 关键：验证实际连接是否成功
    if err := db.Ping(); err != nil {
        log.Fatalf("Failed to connect to DB: %v", err)
    }
    // 可选：配置连接池参数，避免连接耗尽
    db.SetMaxOpenConns(10)
    db.SetMaxIdleConns(5)
}

2. 捕获插入语句的所有错误 #

很多时候你觉得语法正确，但执行时可能因为权限、字段约束（比如非空字段没传、字段类型不匹配）、主键冲突等问题失败，一定要捕获并打印Exec的错误，不要让它悄悄变成500：

// 假设你有一个处理插入的HTTP handler
func insertHandler(w http.ResponseWriter, r *http.Request) {
    // 解析请求数据示例
    var user struct {
        Username string `json:"username"`
        Password string `json:"password"`
    }
    if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
        http.Error(w, "Invalid request body", http.StatusBadRequest)
        return
    }

    // 密码哈希
    hashedPwd, err := bcrypt.GenerateFromPassword([]byte(user.Password), hashCost)
    if err != nil {
        log.Printf("Failed to hash password: %v", err)
        http.Error(w, "Internal server error", http.StatusInternalServerError)
        return
    }

    // 执行插入，用参数占位符?，不要直接拼接字符串！
    result, err := db.Exec("INSERT INTO users (username, password) VALUES (?, ?)", user.Username, string(hashedPwd))
    if err != nil {
        // 关键：打印具体错误，这能帮你定位问题（比如字段不存在、权限不足）
        log.Printf("Failed to execute insert: %v", err)
        http.Error(w, "Internal server error", http.StatusInternalServerError)
        return
    }

    // 可选：检查插入的行数，确认是否成功
    rowsAffected, err := result.RowsAffected()
    if err != nil {
        log.Printf("Failed to get rows affected: %v", err)
        http.Error(w, "Internal server error", http.StatusInternalServerError)
        return
    }
    if rowsAffected == 0 {
        http.Error(w, "No rows inserted", http.StatusInternalServerError)
        return
    }

    w.WriteHeader(http.StatusCreated)
    json.NewEncoder(w).Encode(map[string]string{"message": "User created successfully"})
}

3. 排查常见的隐性问题 #

• 参数占位符错误：MySQL驱动用?作为占位符，不要用PostgreSQL的$1或者直接拼接字符串，后者会导致SQL注入和格式错误。
• 数据库权限问题：确认你的数据库账号有INSERT权限，有时候账号只有读权限会导致插入失败。
• 字段约束冲突：比如插入的字段违反了非空、唯一索引、外键约束，这些错误不会在语法检查时暴露，只有执行时才会报错。
• 事务未提交：如果你开启了事务（db.Begin()），一定要记得Commit()，否则数据不会写入数据库，还会占用连接。

按照上面的步骤排查，你应该能找到具体的错误原因，而不是只看到模糊的“内部服务器错误”。

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