Go で JSON のバリデーションを行う：必須フィールドとゼロ値の落とし穴

type CreateUserRequest struct {
	Name  string `json:"name"`
	Email string `json:"email"`
	Age   int    `json:"age"`
}

func main() {
	data := `{"email":"alice@example.com","age":25}`

	var req CreateUserRequest
	err := json.Unmarshal([]byte(data), &req)

	fmt.Println(err)      // <nil>（エラーなし）
	fmt.Println(req.Name) // ""（空文字列＝ゼロ値）
}

func validateCreateUser(req CreateUserRequest) error {
	if req.Name == "" {
		return fmt.Errorf("name は必須です")
	}
	if req.Email == "" {
		return fmt.Errorf("email は必須です")
	}
	if !strings.Contains(req.Email, "@") {
		return fmt.Errorf("email の形式が不正です")
	}
	if req.Age < 0 || req.Age > 150 {
		return fmt.Errorf("age は 0〜150 の範囲で指定してください")
	}
	return nil
}

func handler(w http.ResponseWriter, r *http.Request) {
	var req CreateUserRequest
	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
		writeError(w, "JSON が不正です", http.StatusBadRequest)
		return
	}

	if err := validateCreateUser(req); err != nil {
		writeError(w, err.Error(), http.StatusBadRequest)
		return
	}

	// バリデーション通過後の処理
}

type UpdateUserRequest struct {
	Name  *string `json:"name"`
	Email *string `json:"email"`
	Age   *int    `json:"age"`
}

func main() {
	data := `{"email":"new@example.com"}`

	var req UpdateUserRequest
	json.Unmarshal([]byte(data), &req)

	fmt.Println(req.Name)  // <nil>（送られなかった）
	fmt.Println(req.Email) // &"new@example.com"（値あり）
	fmt.Println(req.Age)   // <nil>（送られなかった）
}

func validateRequired(data []byte, fields ...string) error {
	var raw map[string]json.RawMessage
	if err := json.Unmarshal(data, &raw); err != nil {
		return err
	}

	for _, field := range fields {
		val, exists := raw[field]
		if !exists {
			return fmt.Errorf("%s は必須です", field)
		}
		if string(val) == "null" {
			return fmt.Errorf("%s に null は指定できません", field)
		}
	}
	return nil
}

func handler(w http.ResponseWriter, r *http.Request) {
	body, _ := io.ReadAll(r.Body)

	if err := validateRequired(body, "name", "email"); err != nil {
		writeError(w, err.Error(), http.StatusBadRequest)
		return
	}

	var req CreateUserRequest
	json.Unmarshal(body, &req)
	// 通常の処理へ
}

func handler(w http.ResponseWriter, r *http.Request) {
	decoder := json.NewDecoder(r.Body)
	decoder.DisallowUnknownFields()

	var req CreateUserRequest
	if err := decoder.Decode(&req); err != nil {
		// "json: unknown field \"namae\"" のようなエラー
		writeError(w, err.Error(), http.StatusBadRequest)
		return
	}
}

type ValidationError struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type ErrorResponse struct {
	Errors []ValidationError `json:"errors"`
}

func validateCreateUser(req CreateUserRequest) []ValidationError {
	var errs []ValidationError

	if req.Name == "" {
		errs = append(errs, ValidationError{
			Field: "name", Message: "name は必須です",
		})
	}
	if req.Email == "" {
		errs = append(errs, ValidationError{
			Field: "email", Message: "email は必須です",
		})
	}
	if req.Email != "" && !strings.Contains(req.Email, "@") {
		errs = append(errs, ValidationError{
			Field: "email", Message: "email の形式が不正です",
		})
	}

	return errs
}

// レスポンス例
{
  "errors": [
    {"field": "name", "message": "name は必須です"},
    {"field": "email", "message": "email は必須です"}
  ]
}