GORM для Go: настройка моделей, миграций и производительность

Официальная документация GORM подтверждает необходимость PreferSimpleProtocol: true и PrepareStmt: false для работы с pgBouncer. Это отключает подготовленные выражения, несовместимые с transaction pooling. Без этой настройки вы получите ошибку "prepared statement \"\" already exists".

Как настроить GORM за 5 шагов

1. Установите GORM и драйвер. Выполните go get gorm.io/gorm и go get gorm.io/driver/postgres.
2. Настройте подключение с PreferSimpleProtocol. В конфигурации драйвера укажите PreferSimpleProtocol: true, а в GORM — PrepareStmt: false.
3. Сконфигурируйте пул соединений. После открытия подключения получите *sql.DB и задайте лимиты: 25 max open, 10 max idle, 5 минут lifetime, 2 минуты idle.
4. Создайте модели с хуками. Используйте хуки BeforeCreate и BeforeUpdate для автоматического заполнения slug и обновления updated_at.
5. Используйте Preload для связей. В репозиториях применяйте Preload, чтобы избежать N+1 запросов.

Как GORM решает проблему N+1 запросов?

Preload заменяет N+1 запросов одним SELECT с IN-условием, сокращая количество запросов в 10 раз. В проекте с 50 товарами и 3 связанными сущностями (категория, теги, изображения) без Preload выполнялось 151 запрос: 1 на товары + 50 на категории + 50 на теги + 50 на изображения. С Preload — всего 4 запроса. Время загрузки страницы уменьшилось с 2 секунд до 200 мс. Preload работает в 10 раз быстрее, чем обычный цикл с N+1 запросами. Экономия от использования правильной конфигурации может составлять до $4.5k–6.5k в год.

Модели, репозитории и оптимизация запросов

Пример модели Product

package models

import (
	"time"

	"gorm.io/gorm"
)

type ProductStatus string

const (
	StatusDraft     ProductStatus = "draft"
	StatusPublished ProductStatus = "published"
	StatusArchived  ProductStatus = "archived"
)

type Product struct {
	ID        uint           `gorm:"primarykey"`
	CreatedAt time.Time
	UpdatedAt time.Time
	DeletedAt gorm.DeletedAt `gorm:"index"`
	Title     string         `gorm:"type:varchar(500);not null"`
	Slug      string         `gorm:"type:varchar(520);uniqueIndex;not null"`
	Price     float64        `gorm:"type:decimal(12,2);not null"`
	Status    ProductStatus  `gorm:"type:varchar(20);default:draft;not null"`
	CategoryID uint          `gorm:"not null;index"`
	Category  Category       `gorm:"foreignKey:CategoryID;constraint:OnDelete:RESTRICT"`
	Tags      []Tag          `gorm:"many2many:product_tags;"`
	Images    []ProductImage `gorm:"foreignKey:ProductID;constraint:OnDelete:CASCADE"`
}

func (Product) TableName() string {
	return "products"
}

Репозиторий с Preload, транзакциями и хуками GORM

package repository

import (
	"context"
	"myapp/internal/models"
	"gorm.io/gorm"
)

type ProductRepository struct {
	db *gorm.DB
}

func NewProductRepository(db *gorm.DB) *ProductRepository {
	return &ProductRepository{db: db}
}

func (r *ProductRepository) GetPublished(ctx context.Context, categoryID uint, limit, offset int) ([]models.Product, error) {
	var products []models.Product
	err := r.db.WithContext(ctx).Preload("Category").Preload("Tags").
		Where("category_id = ? AND status = ?", categoryID, models.StatusPublished).
		Order("created_at DESC").Limit(limit).Offset(offset).Find(&products).Error
	return products, err
}

func (r *ProductRepository) CreateWithTags(ctx context.Context, product *models.Product, tagIDs []uint) error {
	return r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
		if err := tx.Create(product).Error; err != nil {
			return err
		}
		var tags []models.Tag
		if err := tx.Find(&tags, tagIDs).Error; err != nil {
			return err
		}
		return tx.Model(product).Association("Tags").Append(tags)
	})
}

// Хуки GORM: BeforeCreate и BeforeUpdate
func (p *Product) BeforeCreate(tx *gorm.DB) error {
	if p.Slug == "" {
		p.Slug = slug.Make(p.Title)
	}
	return nil
}

func (p *Product) BeforeUpdate(tx *gorm.DB) error {
	tx.Statement.SetColumn("UpdatedAt", time.Now().UTC())
	return nil
}

Почему AutoMigrate опасен в production?

AutoMigrate не умеет накапливать изменения без риска потери данных — он может удалить столбцы или таблицы. На одном проекте мы потеряли несколько столбцов из-за непреднамеренного вызова AutoMigrate после изменения модели. Версионированные миграции дают полный контроль и возможность отката. Для production используем golang-migrate с SQL-миграциями.

Пример SQL-миграции

-- migrations/000002_create_products.up.sql
CREATE TABLE products (
    id BIGSERIAL PRIMARY KEY,
    title VARCHAR(500) NOT NULL,
    slug VARCHAR(520) NOT NULL UNIQUE,
    price DECIMAL(12, 2) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'draft',
    category_id BIGINT NOT NULL REFERENCES categories(id) ON DELETE RESTRICT,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    deleted_at TIMESTAMPTZ
);
CREATE INDEX idx_products_status_created ON products (status, created_at DESC);
CREATE INDEX idx_products_category ON products (category_id, status);
CREATE INDEX idx_products_deleted_at ON products (deleted_at);

Сравнение AutoMigrate и версионированных миграций

Что входит в настройку GORM

Мы предоставляем:

• Настроенное подключение к БД с пулом соединений (25 open, 10 idle, 5 мин lifetime)
• Репозитории с Preload и транзакциями
• Версионированные SQL-миграции с возможностью отката
• Тесты с testcontainers-go
• Документацию по стеку и конфигурации
• Поддержку в течение 2 недель после сдачи

Сроки

Начальная настройка GORM с миграциями для нового Go-проекта занимает от 1 дня до недели в зависимости от количества моделей и сложности бизнес-логики. Стоимость рассчитывается индивидуально. Экономия от оптимизации может составить до $4.5k–6.5k в год.

Свяжитесь с нами, чтобы узнать точную стоимость и сроки. Опытные инженеры с 5-летним стажем гарантируют стабильную работу вашего приложения.