ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS
TLSServer 생성 시 TLS 옵션에 ALPNProtocols와 ALPNCallback을 함께 지정하면 발생하는 Node.js 오류입니다.
빠른 답변
- 확인 범위
- ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS는 TLSServer 생성 시 ALPNProtocols와 ALPNCallback을 함께 지정했을 때 발생하며, 두 옵션은 함께 사용할 수 없습니다.
- 먼저 확인할 항목
- 오류 객체의 code 값 또는 로그 문자열이 ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS인지 확인합니다.
- 적용 범위
- 화면 또는 로그에 같은 오류 메시지·상태명이 표시된 경우문맥: 바이브 코딩
- 출처
- Node.js
- 출처 확인일
- 2026-07-24
- 최종 검토
- 2026-07-24
- 정정 이력
- 2026-07-29 이후 기록 없음
- 관련 기술
이 문서의 범위
이 문서는 화면·로그의 오류 메시지 또는 상태명을 공식 자료와 대조하는 데 사용합니다. 이 문구만으로 실제 원인이나 변경 방법을 확정하지 않으며, 아래 관련 기술 문서에서 적용 환경을 추가로 확인해야 합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
오류 객체의 code 값 또는 로그 문자열이 ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS인지 확인합니다.
TLSServer 생성에 전달한 TLS 옵션에 ALPNProtocols와 ALPNCallback이 모두 포함되는지 확인합니다.
오류 메시지·상태명 확인 범위
의미
ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS는 TLSServer를 만들 때 TLS 옵션에 ALPNProtocols와 ALPNCallback이 모두 포함된 경우 발생합니다. Node.js는 두 옵션을 함께 사용할 수 없다고 설명합니다.
확인
- 현재 오류 객체의
code값 또는 로그에ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS가 표시되는지 확인합니다. - 해당
TLSServer생성 코드의 TLS 옵션에ALPNProtocols와ALPNCallback이 모두 있는지 확인합니다.
두 항목이 모두 확인되면 Node.js 문서가 설명하는 이 오류에 해당합니다.
출처
참고 자료
Errors | Node.js v26.5.0 Documentation (새 창에서 열림)
Node.js · 공식 자료 · 확인 범위: Node.js는 TLSServer 생성 시 TLS 옵션에 ALPNProtocols와 ALPNCallback이 모두 포함되면 ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS를 발생시킨다고 설명합니다., Node.js는 ALPNProtocols와 ALPNCallback이 상호 배타적인 옵션이라고 설명합니다. · 확인일: 2026-07-24