为了避免 golang 框架中常见错误,需要:控制器函数中处理错误并返回适当的 http 状态代码。使用 validator 库或自定义验证函数验证用户输入。使用 errors 库处理和格式化错误信息。在函数作用域内使用变量或使用并发安全的数据结构。
Golang 框架常见错误及避免方法
1. 控制器(Handler)函数不完整
常见的错误是编写了一个控制器函数,却没有处理错误情况。这会导致服务器返回不明确的错误,并且难以调试。
立即学习“go语言免费学习笔记(深入)”;
解决方案: 在控制器函数中始终处理错误,并返回适当的 HTTP 状态代码。例如:
func (h *handler) Index(w http.ResponseWriter, r *http.Request) { results, err := h.db.Query("SELECT * FROM users") if err != nil { http.Error(w, "Internal Server Error", http.StatusInternalServerError) return } users := make([]user, 0) for results.Next() { var u user if err := results.Scan(&u.ID, &u.Name, &u.Email); err != nil { http.Error(w, "Internal Server Error", http.StatusInternalServerError) return } users = append(users, u) } json.NewEncoder(w).Encode(users) }
2. 没有正确验证数据
应用程序应验证用户输入的数据,以防止恶意攻击和无效输入。
解决方案: 使用 Validator 库或编写自定义验证函数来验证输入。例如:
type User struct { Name string Email string Password string } // NewUser creates a new user from the given data. func NewUser(name, email, password string) (*User, error) { u := &User{ Name: name, Email: email, Password: password, } validator := validator.New() if err := validator.Struct(u); err != nil { return nil, err } return u, nil }
3. 不正确的错误处理
错误应正确处理,并以清晰易懂的方式呈现给用户。
解决方案: 使用 errors 库来处理和格式化错误信息。例如:
var ErrUserNotFound = errors.New("user not found") // FindUserByEmail finds a user by their email address. func (h *handler) FindUserByEmail(w http.ResponseWriter, r *http.Request) { email := r.FormValue("email") u, err := h.db.GetUserByEmail(email) if err == ErrUserNotFound { http.Error(w, "User not found", http.StatusNotFound) return } else if err != nil { http.Error(w, "Internal Server Error", http.StatusInternalServerError) return } json.NewEncoder(w).Encode(u) }
4. 在全局作用域中使用包级变量
这可能会导致种族条件和其他难以调试的问题。
解决方案: 在函数作用域内使用所有变量,或使用并发安全的数据结构。例如,使用 sync.Mutex 对并发访问的数据结构进行保护:
var users []user var mu sync.Mutex // AddUser adds a user to the list. func AddUser(u *user) { mu.Lock() defer mu.Unlock() users = append(users, *u) }