Oracle ORA-12541 TNS no listenerの解決方法【2025年最新版】

エラーの概要・症状
このエラーが発生する原因
解決方法1（最も効果的）
解決方法2（代替手段）
解決方法3（上級者向け）
エラーの予防方法
関連するエラーと対処法
まとめ

エラーの概要・症状

Oracleデータベースを使用しているときに、接続を試みると「ORA-12541: TNS:no listener」というエラーメッセージが表示されることがあります。このエラーは、データベースへの接続を試みた際に、リスナーが起動していない、または正しく設定されていないことを示しています。具体的には、以下のような状況で発生します。

データベースに接続しようとしたが、リスナーが応答しない。
SQL*Plusや他のOracleクライアントから接続を試みた際に、このエラーメッセージが表示される。

このエラーが発生すると、データベースにアクセスできなくなり、アプリケーションの機能が制限されるため、迅速な解決が求められます。

このエラーが発生する原因

「ORA-12541: TNS:no listener」エラーが発生する原因は複数あります。以下に主要な原因を挙げ、それぞれについて詳細に説明します。

リスナーが起動していない: Oracleデータベースは、クライアントからの接続要求を処理するためにリスナーというプロセスを使用します。リスナーが起動していない場合、クライアントはデータベースに接続できません。
リスナーの設定ミス: listener.oraファイルやtnsnames.oraファイルに誤った設定があると、リスナーが正しく機能しないことがあります。特に、ホスト名やポート番号が誤っている場合、このエラーが発生します。
ファイアウォールやネットワークの問題: リスナーが正しく設定されていても、ファイアウォールやネットワーク設定によって接続がブロックされることがあります。この場合、特定のポートへのアクセスを許可する必要があります。
Oracleインスタンスが停止している: Oracleデータベースのインスタンスが異常停止している場合、リスナーは新しい接続を受け付けることができません。
環境変数の設定ミス: Windows環境では、ORACLE_HOMEやTNS_ADMINなどの環境変数が正しく設定されていない場合、接続に失敗することがあります。これは特に複数のOracleクライアントがインストールされている場合に起こります。

解決方法1（最も効果的）

手順1-1（リスナーの起動）

まず最初に、リスナーが起動しているか確認し、必要に応じてリスナーを起動します。以下の手順に従ってください。

コマンドプロンプトを管理者権限で開きます。
次のコマンドを入力してリスナーの状態を確認します。

   lsnrctl status

これにより、リスナーが起動しているかどうかが確認できます。もし「リスナーが起動していない」というメッセージが表示された場合は、次のステップに進みます。

手順1-2（リスナーの起動）

リスナーを起動するために、以下のコマンドを入力します。

   lsnrctl start

このコマンドにより、リスナーが起動します。

再度リスナーの状態を確認します。

   lsnrctl status

リスナーが正常に起動していれば、接続できるようになります。

注意点とトラブルシューティング

リスナーが起動しない場合、listener.oraの設定を確認します。特に、HOSTとPORTの設定が正しいか確認してください。
リスナーのログファイル（通常は$ORACLE_HOME/network/log/listener.logにあります）をチェックし、エラーメッセージが出力されていないか確認します。

解決方法2（代替手段）

リスナーが起動している場合でも接続できない場合、以下の方法を試してみてください。

tnsnames.oraファイルを確認し、接続情報が正しいか確認します。特に、ホスト名やポート番号が正しいかをチェックします。

   MY_DATABASE =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
       (CONNECT_DATA =
         (SERVICE_NAME = mydb)
       )
     )

listener.oraファイルの内容も確認します。

   LISTENER =
     (DESCRIPTION_LIST =
       (DESCRIPTION =
         (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.1.100)(PORT = 1521))
       )
     )

ここで、HOSTの部分を実際のIPアドレスに置き換えます。

環境変数TNS_ADMINが正しく設定されているかも確認します。これにより、Oracleクライアントが正しいtnsnames.oraファイルを参照できるようになります。

解決方法3（上級者向け）

上級者向けの解決策として、コマンドラインでの設定変更を行います。これには、リスナーの再作成が含まれます。

まず、現在のリスナーを削除します。

   lsnrctl stop
   lsnrctl remove

新しいリスナーを作成します。

   lsnrctl start

新しいリスナーが正常に作成され、起動することを確認します。

最後に、次のコマンドで設定を確認します。

   lsnrctl status

正常に設定が反映されているか確認してください。

エラーの予防方法

このエラーを防ぐためには、以下の予防策を講じることが重要です。

**定期的なメンテナンス**: データベースとリスナーの定期的なチェックを行い、異常があれば早期に対処します。
**バックアップの実施**: listener.oraやtnsnames.oraの設定ファイルを定期的にバックアップし、変更があった際には元に戻せるようにします。
**ネットワーク設定の確認**: ファイアウォールやルーターの設定を定期的に確認し、Oracleデータベースのポート（通常は1521）が開いていることを確保します。

まとめ

「ORA-12541: TNS:no listener」エラーは、Oracleデータベースへの接続において非常に一般的な問題ですが、適切な手順を踏むことで解決可能です。リスナーの起動、設定ファイルの確認、ネットワーク環境の整備を行うことで、このエラーを回避することができます。データベースを安定的に運用するために、定期的なメンテナンスと設定の確認を怠らないようにしましょう。