Error: Unknown error occurred 문의합니다.

[luke7231]

사용 중인 프로그래밍 언어 및 버전

Node.js v20.9.0

SDK 버전

^5.5.1

운영 환경

AWS/클라우드/호스팅 서버 등 상용 웹 서버

질문/문제 설명

Error: Unknown error occurred
2025-07-22 21:01:03     at onFailure (/app/node_modules/solapi/dist/index.js:3:26683)
2025-07-22 21:01:03     at /app/node_modules/effect/dist/cjs/internal/core.js:1435:14
2025-07-22 21:01:03     at Object.match (/app/node_modules/effect/dist/cjs/Function.js:109:18)
2025-07-22 21:01:03     at Y.send (/app/node_modules/solapi/dist/index.js:3:26590)

이런 에러가 납니다. 원인을 모르니.. 고칠 수가 업네요 !

코드 예시

export async function sendAlimTalk(
  to: string,
  templateCode: string,
  variables: Record<string, string>
) {
  if (!to.startsWith("010")) {
    console.error("Error: The recipient's phone number must start with 010.");
    return;
  }

  try {
    const response = await messageService.send({
      from: process.env.SOLAPI_SENDER_PHONE_NUMBER as string,
      to,
      kakaoOptions: {
        pfId: "KA01PF250115005943669TDs6evUirDK", // 플러스친구 ID
        templateId: templateCode, // 템플릿 코드
        variables, // 템플릿 변수
      },
    });
  } catch (error) {
    console.error("Error sending AlimTalk:", error);
  }
}

시도한 해결 방법

No response

기대하는 결과

에러가 나면 안됩니다.

확인사항

• 관련 문서를 확인했습니다
• 이전 토론/이슈에서 유사한 질문이 없는지 확인했습니다
• 문의 전 읽어야 하는 사항(문의 전 꼭 읽어봐주세요! #7)을 확인했습니다

[Palbahngmiyine]

안녕하세요, 솔라피 기술지원팀입니다. 회원님께서는 과거에 5.5.1 버전이 아니라 다른 5버전의 Node.js SDK를 사용하시는 것으로 보입니다.
자세한 확인을 위해 혹여 동일한 파라미터로 발송했을 때 다른 버전의 SDK 에서는 정상 작동하셨을지 문의드립니다.

Unknown Error가 발생하게 되면 일반적인 클라이언트 상 오류가 아닐 가능성이 높아 공개된 기술지원 상담 자체로는 확인하기 어려운 부분이 있어 채팅 상담을 통해 관련한 사항을 좀 더 상세히 말씀해주시면 빠르게 확인하여 답변드릴 수 있도록 하겠습니다.

[luke7231]

서버를 두대에서 솔라피를 동시에 사용합니다,

main server -> ^5.3.1
sub server -> ^5.5.1

sub도 5.3.1로 내려본 후 경과를 지켜보겠습니다.

[Palbahngmiyine]

네, 경과를 지켜보시다가 동일한 현상이 발생되시면 채팅상담을 통해 상세한 파라미터나 관련 조건들을 공유해주시면 빠르게 확인 후 답변드릴 수 있도록 하겠습니다.

[luke7231]

sdk 다운그레이드 후에도 문제가 지속됩니다.

추가정보.

[7/23 08:30]

• 14개의 알림톡 발송
• 한개의 알림톡 발송에서 Unknown error occurred 다시 발생.

[그후 5분뒤]
08:35분에 탈락된 한개의 알림톡 요청건에 대해 솔라피에서 자동으로 다시 발송한듯 보임.

[luke7231]

1. 일단 1개 탈락하는 것도 어떤 이유인지 가늠이 안되어 내심 답답한 부분이 있고,
2. 문제는 운영하는 서비스 특성상 고객들의 실시간 주문확정 정보를 담아서 전송하는데, 1분차이가 굉장히 고객들에게 예민하게 반응이 나오다보니, 5분뒤에 다시 보내는 것도 타격이 큼. 그리고 실패할 때마다 다시 보내주는지도 의문..
3. 다시 보냈는지 확인하는 것도 서버 로그와 솔라피 대시보그 메세지 로그를 일일이 대조해서 찾아봐야해서 시간적 소모가 큰 상황

[Palbahngmiyine]

SDK 버전 다운그레이드 시에도 관련한 오류가 발생하신다면 채팅 상담을 통해 자세한 확인이 필요한 것으로 보입니다.
말씀하신 것 처럼 오류가 발생하면 고객 경험에 큰 영향을 미치는 점은 충분히 공감되는 사항인 것 같습니다.

빠른 해결을 위해 해당 채팅 상담을 통해 발송 당시 파라미터, 재발송 했다고 확인하신 해당 메시지의 메시지 ID를 채팅상담에 남겨주시면 빠르게 확인 후 답변드릴 수 있도록 하겠습니다.

그 외에 솔라피에서는 접수에 실패했거나 혹은 발송에 실패한 건을 재발송처리 하진 않습니다. 이 점은 참고 부탁드리겠습니다.