sql: unknown driver "postgres" (forgotten import?)
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
import "database/sql"
db, err := sql.Open("postgres", dsn)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
import _ "github.com/jackc/pgx/v5/stdlib"
db, err := sql.Open("postgres", dsn)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ă 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 OKpackage 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")
}Drivere: [memdb] Conexiune OK
Indiciu
Numele din sql.Open trebuie să fie cel din sql.Register.
Reparația
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("memdb", "magazin")
if err != nil {
log.Fatal(err)
}
defer db.Close()
if err := db.Ping(); err != nil {
log.Fatal(err)
}
fmt.Println("Conexiune OK")
}De ce merge
sql.Open caută numele primit în lista driverelor înregistrate, iar acolo era doar memdb. Cu numele corect, Open găsește driverul, iar Ping deschide o conexiune prin el. Într-un proiect real, înregistrarea o face importul _ "github.com/lib/pq", care înregistrează numele postgres.
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
sql: no rows in result set QueryRow(...).Scan nu a găsit niciun rând pentru interogare. Nu e o defecțiune a bazei, ci răspunsul „nu există”: verifică errors.Is(err, sql.ErrNoRows) și tratează cazul separat (404, mesaj, valoare implicită). "os" imported and not used Ai importat un pachet pe care nu îl folosești în fișier. În Go asta e eroare de compilare. Șterge importul sau folosește pachetul; editoarele cu goimports adaugă și șterg automat importurile. package string is not in std Importul cere un pachet care nu există în biblioteca standard, de obicei din cauza unei greșeli de scriere ("string" în loc de "strings", "maths" în loc de "math"). Corectează calea din import; pentru pachete externe, rulează go get în modulul tău. Î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.
