【GO言語】mysqlへの接続でやらかしたこと

やろうとしたこと

GO言語の公式チュートリアルのコードを基に（ほぼコピペ）ローカルのmysqlサーバに接続して、DBのデータを参照したり、書き込んだりするプログラムを書こうとしました。

書いたコード（エラー解消前）

以下、エラーが発生するコードです。

main.go

package main

import (
	"database/sql"
	"fmt"
	"log"

	"github.com/go-sql-driver/mysql"
)

var db *sql.DB

type Album struct {
	ID     int64
	Title  string
	Artist string
	Price  float32
}

func albumByArtist(name string) ([]Album, error) {
	var albums []Album

	rows, err := db.Query("SELECT * FROM album WHERE artist = ?", name)

	if err != nil {
		return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
	}

	defer rows.Close()

	for rows.Next() {
		var alb Album
		err := rows.Scan(&alb.ID, &alb.Title, &alb.Artist, &alb.Price)
		if err != nil {
			return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
		}
		albums = append(albums, alb)
	}

	if err := rows.Err(); err != nil {
		return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
	}

	return albums, nil

}

func main() {
	//connect to DB
	cfg := mysql.Config{
		User:                 "user",
		Passwd:               "pass",
		Net:                  "tcp",
		Addr:                 "localhost:3306",
		DBName:               "recording",
		AllowNativePasswords: true,
	}

	//get a database handle
	var err error
	db, err := sql.Open("mysql", cfg.FormatDSN())

	if err != nil {
		log.Fatal(err)
	}

	pingErr := db.Ping()
	if pingErr != nil {
		log.Fatal(pingErr)
	}

	fmt.Println("connect to DB!")

	var albums []Album
	albums, err = albumByArtist("John Coltrane")

	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("Albums found: %v\n", albums)

}

これを実行すると以下のエラーが発生します。
panic: runtime error: invalid memory address or nil pointer dereference

エラーの原因

かなり初歩的なミスでしたが、main()内のsql.Open()の書き方にミスがありました。

• 正：db, err = sql.Open("mysql", cfg.FormatDSN())
• 誤：db, err := sql.Open("mysql", cfg.FormatDSN())

=とすべきところ、うっかり:=と書いてしまったことが原因でした。

複数の関数内で共通のDBのコネクションを使うためグローバル変数として定義する必要があります。
ところが、main()内のsql.Open()を実行する際に:=としてしまうと、
左辺のdbはmain()内のローカル変数として定義されてしまいます。

そして、albumByArtist()内でDBにクエリを投げようと、グローバル変数のDBのコネクションを利用しようとしても、グローバル変数のコネクションがnilなので上記のエラーが発生したというわけです。
（当然main()内のコネクションにはデータが格納されています。）

最後に

GO言語を勉強したてで、意識して=と:=の使い分けができていなかったため発生したエラーでした。
気をつけていきたいですね。