为了避免 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)
}