백엔드 · 오류·증상

ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS

저자: Woody
최종 검토: 2026-07-24
참고 자료: 있음
관련 기술: SSL/TLS

빠른 답변

이 오류는 무엇인가요?: TLSServer 생성 시 TLS 옵션에 ALPNProtocols와 ALPNCallback을 함께 지정하면 발생하는 Node.js 오류입니다.
가장 흔한 원인은 무엇인가요?: ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS는 TLSServer 생성 시 ALPNProtocols와 ALPNCallback을 함께 지정했을 때 발생하며, 두 옵션은 함께 사용할 수 없습니다.
무엇을 먼저 확인해야 하나요?: 오류 객체의 code 값 또는 로그 문자열이 ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS인지 확인합니다.

현재 증상

애플리케이션 오류 메시지

먼저 확인할 항목

오류 객체의 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 문서가 설명하는 이 오류에 해당합니다.

출처

Node.js Errors: ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS (새 창에서 열림)

참고 자료

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