좋은 에러 메시지는 무엇을 말해야 할까

"알 수 없는 오류가 발생했습니다." 이 문장을 볼 때마다 사용자는 무력해진다. 좋은 에러 메시지는 세 가지를 말한다.

1. 무엇이 안 됐는지
2. 왜 안 됐는지 (알 수 있다면)
3. 그래서 어떻게 하면 되는지

throw new UserError(
    '사진을 올리지 못했습니다. 파일이 10MB를 넘습니다.',
    hint: '크기를 줄여 다시 올려 주세요.'
);

개발자에게 필요한 정보(스택, 요청 번호)는 로그에 남기고, 사용자에게는 다음 행동만 알려 주자.