코드만 보이는 화면은 이용자를 멈추게 합니다
문의 양식을 제출했는데 알아볼 수 없는 영문 코드만 나타나면 이용자는 입력을 고쳐야 하는지, 잠시 뒤에 다시 시도해야 하는지 판단할 수 없습니다. 내부 코드는 담당자가 원인을 추적할 때 도움이 되지만, 이용자에게 보이는 안내의 전부가 되어서는 곤란합니다. 오류 메시지가 해야 할 일은 무슨 일이 생겼는지 범위를 알려 주고, 지금 할 수 있는 행동을 제시하는 것입니다.
아래에서는 오류의 종류를 나누는 방법, 결제나 예약처럼 중요한 행동에서 주의할 점, 메시지를 놓는 위치와 접근성, 화면 문구와 내부 기록을 분리하는 방법을 순서대로 살펴봅니다.
입력 오류와 서비스 장애를 먼저 구분하기
이용자가 고칠 수 있는 문제와 그렇지 않은 문제는 문구의 방향이 완전히 달라야 합니다. 필수 항목이 비어 있다면 어느 항목인지 정확히 표시하고, 이미 입력한 다른 값은 지워지지 않게 유지해야 합니다. 값을 다시 쓰게 만드는 화면은 오류 자체보다 더 큰 불편을 남깁니다.
서버나 외부 인증처럼 이용자의 잘못이 아닌 문제라면 이용자가 잘못한 것처럼 읽히는 표현을 피합니다. 잠시 뒤 다시 시도하거나 공식 지원 경로를 확인하도록 안내하되, 실제로 확인되지 않은 복구 시간을 약속하지 않습니다. "곧 해결됩니다" 같은 문장은 근거가 없다면 쓰지 않는 편이 신뢰를 지킵니다.
결제와 예약에서는 완료 여부가 가장 중요합니다
중요한 행동 뒤에 오류 화면이 나타나도 실제로는 처리가 접수되었을 수 있습니다. 이때 확인 없이 다시 제출하라고 안내하면 중복 신청이나 중복 결제로 이어질 수 있습니다. 그래서 현재 상태를 확인할 수 있는 경로를 함께 제공하는 것이 좋습니다. 예를 들어 접수 내역을 조회하는 화면으로 이어지는 링크가 있다면 이용자는 다시 제출하기 전에 먼저 확인할 수 있습니다.
운영자가 추가로 확인해야 하는 경우에는 어떤 정보가 필요한지 최소한의 범위로 안내합니다. 개인정보나 결제 정보를 공개 댓글이나 게시판에 남기라고 요청하지 않도록 하고, 비공개 문의 경로를 따로 마련합니다.
메시지를 놓는 위치와 전달 방식 점검하기
문구가 좋아도 위치가 어긋나면 찾기 어렵습니다. 화면 맨 위에 "오류가 있습니다"라고만 표시되고 실제 문제가 있는 입력란은 아래쪽에 있다면 이용자는 직접 찾아다녀야 합니다. 설명은 해당 항목 가까이에 두고, 가능하면 첫 번째 문제가 있는 항목으로 키보드 초점이 이동하도록 합니다.
화면 읽기 프로그램을 쓰는 사람에게도 오류가 전달되는지 확인해야 합니다. 또한 색상만으로 오류 상태를 구분하면 색을 구별하기 어려운 사람이 놓칠 수 있으므로 문구나 아이콘을 함께 사용합니다. 모바일과 컴퓨터 화면에서 메시지가 잘리거나 입력창에 가려지지 않는지도 직접 시험해 봅니다.
이용자에게 보이는 문구와 내부 기록을 나누기
화면에 보이는 문구와 내부 로그는 목적이 다릅니다. 지원 담당자가 추적할 수 있도록 내부 코드와 발생 시각은 기록하되, 민감한 시스템 정보가 공개 화면에 드러나지 않도록 합니다. 문의할 때 필요한 접수 번호가 있다면 개인정보가 아닌 범위에서 보여 줄 수 있습니다.
이용자에게 오류 상황을 설명하려고 화면 전체나 민감한 입력값을 캡처해 보내라고 요구하는 것도 신중해야 합니다. 꼭 필요한 정보가 무엇인지 항목으로 정해 두고, 그 외의 내용은 보내지 않아도 된다고 알려 주는 편이 안전합니다.
오류 문구를 새로 만들 때는 실제 사례를 모아 두는 것도 도움이 됩니다. 문의 담당자가 자주 받은 질문과 이용자가 포기한 단계를 함께 보면, 어떤 오류에서 설명이 부족한지 구체적으로 알 수 있습니다.
문구만 바꾸지 말고 원인을 고치기
메시지가 실제 시스템 동작과 일치하는지는 발행 전에 시험으로 확인합니다. 안내에는 다시 시도하라고 적혀 있는데 같은 오류가 계속 난다면 문구가 거짓이 됩니다. 같은 오류가 반복되면 문구를 더 친절하게 고치는 데서 멈추지 말고 원인 자체를 해결해야 합니다.
좋은 오류 메시지는 이용자에게 코드를 해독하라고 요구하지 않습니다. 자신의 작업이 어떤 상태인지 이해하고 안전한 다음 단계를 스스로 고를 수 있게 돕습니다. 사이트마다 사용하는 양식과 시스템이 다르므로, 위 기준은 실제 화면에서 담당자와 함께 점검하며 맞추어 가시기 바랍니다.