...
Eroare Go · Fișiere, timp și rețea

sql: unknown driver "postgres" (forgotten import?)

Pe scurt

sql.Open nu găsește un driver înregistrat cu acel nume. Driverul se înregistrează când îi imporți pachetul, de obicei doar pentru efect: import _ "github.com/lib/pq" (postgres) sau _ "github.com/go-sql-driver/mysql" (mysql). Verifică și că numele din sql.Open e exact cel al driverului.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Pachetul database/sql nu conține drivere, ci doar interfața comună. Fiecare driver se înregistrează singur sub un nume ("postgres", "pgx", "mysql", "sqlite3", "sqlite") în funcția lui init, care rulează când pachetul driverului este importat. Dacă nimeni nu l-a importat, sau numele din sql.Open nu se potrivește, primești sql: unknown driver "postgres" (forgotten import?).

Pentru că nu folosești direct niciun nume din pachetul driverului, îl imporți cu _: import _ "github.com/lib/pq". Fără _, compilatorul l-ar marca imported and not used, iar editoarele care șterg automat importurile nefolosite îl pot elimina.

Ca să vezi ce drivere sunt înregistrate, afișează sql.Drivers().

De ce apare: cauzele frecvente

1Lipsește importul driverului

Greșit
GO
import "database/sql"

db, err := sql.Open("postgres", dsn)
Corect
GO
import (
	"database/sql"

	_ "github.com/lib/pq"
)

db, err := sql.Open("postgres", dsn)

Importul cu _ rulează init din driver, care îl înregistrează ca postgres.

2Nume de driver greșit

Greșit
GO
import _ "github.com/jackc/pgx/v5/stdlib"

db, err := sql.Open("postgres", dsn)
Corect
GO
import _ "github.com/jackc/pgx/v5/stdlib"

db, err := sql.Open("pgx", dsn)

Fiecare driver are numele lui: pgx se înregistrează ca pgx, modernc.org/sqlite ca sqlite, mattn/go-sqlite3 ca sqlite3.

Repară tu

Repară eroarea, direct în pagină

În editor nu poți instala un driver real, așa că fișierul conține un driver demonstrativ, înregistrat în init cu numele memdb (exact cum face un driver real când îl imporți). Programul deschide baza cu numele postgres, care nu e înregistrat, și se oprește cu sql: unknown driver "postgres" (forgotten import?). Folosește numele driverului înregistrat, ca programul să afișeze:

Drivere: [memdb]
Conexiune OK
Codul care dă eroarea
GO
package main

import (
	"database/sql"
	"database/sql/driver"
	"errors"
	"fmt"
	"log"
)

// Un driver minim, ca exemplu (un driver real vine din import _ "...").
type memDriver struct{}
type memConn struct{}

func (memDriver) Open(dsn string) (driver.Conn, error) { return memConn{}, nil }
func (memConn) Prepare(q string) (driver.Stmt, error)  { return nil, errors.New("neimplementat") }
func (memConn) Close() error                           { return nil }
func (memConn) Begin() (driver.Tx, error)              { return nil, errors.New("neimplementat") }

func init() {
	sql.Register("memdb", memDriver{})
}

func main() {
	fmt.Println("Drivere:", sql.Drivers())
	db, err := sql.Open("postgres", "magazin")
	if err != nil {
		log.Fatal(err)
	}
	defer db.Close()
	if err := db.Ping(); err != nil {
		log.Fatal(err)
	}
	fmt.Println("Conexiune OK")
}
După reparație, programul afișează
Drivere: [memdb]
Conexiune OK
Indiciu

Numele din sql.Open trebuie să fie cel din sql.Register.

Alte forme ale mesajului

  • sql: unknown driver "mysql" (forgotten import?)
  • sql: unknown driver "sqlite3" (forgotten import?)
  • sql: Register called twice for driver postgres

Cum o eviți pe viitor

Pune importul driverului lângă codul care deschide conexiunea (de obicei în main sau în pachetul db) și păstrează numele driverului într-o constantă. Verifică eroarea de la sql.Open și apelează imediat db.Ping(), pentru că Open nu se conectează efectiv și unele probleme apar doar la prima interogare.

Întrebări frecvente

De ce sql.Open nu dă eroare dacă parola e greșită?

sql.Open doar pregătește un pool de conexiuni. Conectarea reală se face la prima operație; de aceea apelezi db.Ping() (sau PingContext) imediat după Open.

Ce face importul cu _?

Importă pachetul doar pentru efectele lui de inițializare (variabile globale și init), fără să-i folosești numele în cod.

Erori înrudite

← Toate erorile Go

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Go de la zero, cu exerciții la fiecare lecție

Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.