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 запросами. Экономия от использования правильной конфигурации может составлять до 500 000 рублей в год.

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

Пример модели 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 дня до недели в зависимости от количества моделей и сложности бизнес-логики. Стоимость рассчитывается индивидуально. Экономия от оптимизации может составить до 500 000 рублей в год.

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