go-gorm/gorm · error

duplicated key not allowed

Error message

duplicated key not allowed

What it means

Error "duplicated key not allowed" thrown in go-gorm/gorm.

Source

Thrown at errors.go:49

	ErrUnsupportedDriver = errors.New("unsupported driver")
	// ErrRegistered registered
	ErrRegistered = errors.New("registered")
	// ErrInvalidField invalid field
	ErrInvalidField = errors.New("invalid field")
	// ErrEmptySlice empty slice found
	ErrEmptySlice = errors.New("empty slice found")
	// ErrDryRunModeUnsupported dry run mode unsupported
	ErrDryRunModeUnsupported = errors.New("dry run mode unsupported")
	// ErrInvalidDB invalid db
	ErrInvalidDB = errors.New("invalid db")
	// ErrInvalidValue invalid value
	ErrInvalidValue = errors.New("invalid value, should be pointer to struct or slice")
	// ErrInvalidValueOfLength invalid values do not match length
	ErrInvalidValueOfLength = errors.New("invalid association values, length doesn't match")
	// ErrPreloadNotAllowed preload is not allowed when count is used
	ErrPreloadNotAllowed = errors.New("preload is not allowed when count is used")
	// ErrDuplicatedKey occurs when there is a unique key constraint violation
	ErrDuplicatedKey = errors.New("duplicated key not allowed")
	// ErrForeignKeyViolated occurs when there is a foreign key constraint violation
	ErrForeignKeyViolated = errors.New("violates foreign key constraint")
	// ErrCheckConstraintViolated occurs when there is a check constraint violation
	ErrCheckConstraintViolated = errors.New("violates check constraint")
)

View on GitHub (pinned to 1d6ce99528)

Solutions

1. Check for duplicate primary/unique key values in the data being inserted.
2. Use clause.OnConflict to handle duplicates (DoNothing or UpdateAll).
3. Remove duplicate entries from the batch before Create.

Example fix

Deduplicate keys before insert or use ON CONFLICT: db.Clauses(clause.OnConflict{DoNothing: true}).Create(&rows)

When it happens

Trigger: Thrown at errors.go:49 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of go-gorm/gorm@1d6ce99528 (2026-08-15). Data as JSON: /api/errors/89384c756d279201. Report an issue: GitHub.