ERR_TLS_CERT_ALTNAME_INVALID
빠른 답변
- 이 오류는 무엇인가요?
- Node.js TLS 연결에서 피어의 호스트 이름 또는 IP가 인증서의 subjectAltName과 일치하지 않을 때 식별되는 오류 코드입니다.
- 가장 흔한 원인은 무엇인가요?
- ERR_TLS_CERT_ALTNAME_INVALID는 TLS 연결 중 피어의 호스트 이름 또는 IP가 인증서의 subjectAltName 어느 항목과도 일치하지 않았음을 나타냅니다.
- 무엇을 먼저 확인해야 하나요?
- 오류 객체의 `error.code`가 `ERR_TLS_CERT_ALTNAME_INVALID`인지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
오류 객체의 `error.code`가 `ERR_TLS_CERT_ALTNAME_INVALID`인지 확인합니다.
현재 연결에 사용한 피어의 호스트 이름 또는 IP가 인증서의 `subjectAltName` 어느 항목과도 일치하지 않는다는 오류 의미를 확인합니다.
환경별 원인과 조치
확인 방법
애플리케이션의 오류 객체에서 error.code 값을 확인합니다.
- 값이
ERR_TLS_CERT_ALTNAME_INVALID와 일치하면 이 문서의 오류 코드에 해당합니다. - 이 오류 코드는 TLS 연결 중 피어의 호스트 이름 또는 IP가 인증서의
subjectAltName어느 항목과도 일치하지 않았음을 뜻합니다.
Node.js는 오류 메시지 문자열이 버전 사이에 변경될 수 있으므로 오류 식별에는 error.code 사용을 안내합니다.
출처
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js는 error.code를 오류 식별에 사용하는 가장 안정적인 방법으로 설명합니다., ERR_TLS_CERT_ALTNAME_INVALID는 TLS 사용 중 피어의 호스트 이름 또는 IP가 인증서의 subjectAltName 어느 항목과도 일치하지 않을 때 발생합니다. · 확인일: 2026-07-24