Goにおける「dial tcp: connect: connection refused」エラーの解決方法

エラーを読み解く`go run main.go`を実行した際、アプリが起動する代わりに`connection refused`で終わる大量のテキストが表示されることがあります。イライラする瞬間ですが、このメッセージは実は非常に具体的です。Goの`net`パッケージは、コードがターゲットIP（`127.0.0.1`など）を見つけることには成功したものの、転送先のOSが指定されたポート（`5432`など）でのリクエストを能動的に拒否した場合にこのエラーをスローします。

これは、有効な電話番号にダイヤルしたものの、相手がその特定の回線での通話を拒否しているために、すぐに電話を切られてしまうような状況だと考えてください。

サービスが起動していない: データベース（PostgreSQL、Redisなど）が実際には動作していません。- ポート番号の間違い: ポート5432に接続しようとしていますが、サービスは実際には5433や8080で待機しています。- 隔離状態: サービスは動作していますが、ローカル・トラフィックのみを待機しており、別のネットワークインターフェースからのアクセスを拒否しています。- Dockerの罠: Goアプリがコンテナ内で動作しており、localhostがホストマシンではなくコンテナ自身を指しています。## ステップバイステップの修正方法### 1. サービスの状態を確認するまず、ターゲットとなるサービスが実際に稼働しているか確認してください。ポート5432でPostgreSQLを使用している場合は、すぐにその状態をチェックしましょう。サービスがクラッシュしているか、起動していないことが最も一般的な原因です。

# Linux (systemd) の場合
systemctl status postgresql

# macOS (Homebrew) の場合
brew services list

ステータスがinactive（停止中）またはstoppedとなっている場合は、起動してください。インストールされていない場合は、それが最初の解決すべき課題となります。

// TCPハンドシェイクの試行
conn, err := net.Dial("tcp", "127.0.0.1:5432")
if err != nil {
    log.Fatalf("接続に失敗しました: %v", err)
}

lsofを使用して、そのポートで実際に何かが待機しているか確認してください。出力が空の場合、どのサービスもそのポートを使用していません。

# ポート5432のリスナーを探す
sudo lsof -i :5432
# またはnetstatで素早く確認する
netstat -tuln | grep 5432

OSに合わせて接続文字列を更新してください。

macOSおよびWindows: 127.0.0.1をhost.docker.internalに置き換えます。- Linux: ゲートウェイIP（通常は172.17.0.1）を使用するか、コンテナを--network="host"で実行してホストのネットワークスタックを共有します。### 4. バインドアドレスを確認するサービスの設定が原因の場合もあります。127.0.0.1でのみリッスンするように設定されていると、外部IPやDockerブリッジからのリクエストをすべて無視します。postgresql.confや同様の設定ファイルを確認してください。

# postgresql.conf
listen_addresses = 'localhost'  # 厳格：ローカルアプリのみ接続可能
listen_addresses = '*'          # 開放：任意のインターフェースからの接続を許可

これを'*'に変更した後、変更を反映させるためにサービスを再起動する必要があります。

# 簡易的な疎通テスト
nc -vz 127.0.0.1 5432

接続に成功すると、Connection to 127.0.0.1 port 5432 [tcp/postgresql] succeeded!と表示されます。依然としてrefusedと表示される場合は、Goのコードではなく、ファイアウォールやサービスの設定に問題があります。