Oracle ORA-12541 에러 해결 방법 - 리스너 없음 오류 처리하기

오라클 21c 설치 후 DBeaver와 같은 툴로 데이터베이스에 연결하려고 할 때, 다음과 같은 오류가 발생하는 경우가 있습니다.

ORA-12541: TNS: 리스너가 없습니다

이 에러는 Oracle Listener가 작동하지 않거나, 제대로 설정되지 않았을 때 발생합니다. 대부분 다음 두 가지 원인으로 나뉩니다.

1. Oracle Listener가 실행되지 않았거나 강제로 종료된 경우
2. 리스너 설정에는 문제가 없지만, 연결할 데이터베이스 인스턴스가 등록되지 않은 경우

이 문제를 해결하려면 리스너 상태 확인 → 설정 파일 수정 → 데이터베이스 인스턴스 등록 순서로 점검하면 됩니다.

1. Oracle Listener 실행 여부 확인

먼저 Listener가 실행 중인지 확인합니다.

작업 관리자(Task Manager) → Oracle Listener 프로세스가 실행 중인지 확인하기 위해 CMD를 실행 후 아래명령어를 입력합니다.

lsnrctl status

리스너가 중지된 경우 다음 명령어로 시작합니다.

lsnrctl start

만약 계속 중지된다면, 설정 파일의 HOST 값이 현재 컴퓨터 이름과 다를 가능성이 높습니다.

2. listener.ora, tnsnames.ora 파일 수정

Oracle 설치 경로에서 다음 위치로 이동합니다ㅏ.

[Oracle 설치 경로]\network\admin\

• listener.ora
• tnsnames.ora

두 파일 모두에서 HOST = 컴퓨터이름 항목을 현재 사용 중인 컴퓨터 이름과 동일하게 수정합니다.

(예: HOST = myPCname)

저장 후 다시 리스너를 시작합니다.

lsnrctl start

3. Oracle Listener에 DB 인스턴스 등록

리스너가 정상적으로 작동하지만 여전히 ORA-12541 에러가 발생한다면, 연결할 데이터베이스 인스턴스가 등록되지 않은 것입니다.

• Oracle Net Manager를 관리자 권한으로 실행
• 리스너 → 수신자 구성 추가 → 인스턴스 정보(SID, DB 이름) 등록 후 저장

수정 후 리스너를 재시작합니다.

lsnrctl stop
lsnrctl start

정상적으로 ORCL 또는 설정한 인스턴스 이름이 등록된 것을 확인할 수 있으며, 이제 DBeaver 등에서 연결 테스트 시 성공 메시지가 나와야 합니다.

FAQ

ORA-12541 오류가 무엇인가요?

Oracle 클라이언트가 서버의 리스너(listener)와 연결하지 못했을 때 발생하는 오류입니다. 대부분 리스너가 꺼져 있거나 잘못된 설정 때문입니다.

리스너는 실행 중인데도 연결이 안 돼요.

listener.ora 또는 tnsnames.ora의 HOST 정보가 현재 컴퓨터 이름과 다르면 리스너가 비정상 작동할 수 있습니다. 컴퓨터 이름을 확인하고 설정을 수정해보세요.

Oracle Net Manager가 뭔가요?

Oracle에서 네트워크 관련 설정을 GUI로 할 수 있는 유틸리티입니다. 인스턴스를 리스너에 연결하거나 DB 접근 설정을 도와줍니다.

리스너에 데이터베이스가 없다는 건 무슨 의미인가요?

리스너는 DB 인스턴스를 알아야 접속을 중계할 수 있습니다. 인스턴스를 등록하지 않으면 리스너가 아무리 실행 중이라도 접속은 불가능합니다.

설정 파일 수정 시 주의할 점은?

파일을 수정할 때 메모장을 관리자 권한으로 실행해야 저장이 가능합니다. 또 HOST 항목은 컴퓨터 이름(예: DESKTOP-XXXXXXX)과 반드시 일치해야 합니다.