java.sql.SQLException: Incorrect string value: '\xF0\x9F'

문제

MySQL 서버에서 특정 텍스트 저장 시 에러 발생

원인

이모지(유니코드)가 포함된 텍스트라서 정상적으로 저장되지 않음

해결

1. Regex를 사용하여 텍스트에서 이모지를 제거
2. MySQL character set encoding을 utf8mb4로 변경
   UTF-8은 4바이트 가변 길이 인코딩 방식인데 MySQL에서는 3바이트로 구현했기 때문에, 4바이트로 된 uft8mb4로 변경해야 함

1.regex 사용

const deleteEmojiRegex = /(?:[\u2700-\u27bf]|(?:\ud83c[\udde6-\uddff]){2}|[\ud800-\udbff][\udc00-\udfff]|[\u0023-\u0039]\ufe0f?\u20e3|\u3299|\u3297|\u303d|\u3030|\u24c2|\ud83c[\udd70-\udd71]|\ud83c[\udd7e-\udd7f]|\ud83c\udd8e|\ud83c[\udd91-\udd9a]|\ud83c[\udde6-\uddff]|\ud83c[\ude01-\ude02]|\ud83c\ude1a|\ud83c\ude2f|\ud83c[\ude32-\ude3a]|\ud83c[\ude50-\ude51]|\u203c|\u2049|[\u25aa-\u25ab]|\u25b6|\u25c0|[\u25fb-\u25fe]|\u00a9|\u00ae|\u2122|\u2139|\ud83c\udc04|[\u2600-\u26FF]|\u2b05|\u2b06|\u2b07|\u2b1b|\u2b1c|\u2b50|\u2b55|\u231a|\u231b|\u2328|\u23cf|[\u23e9-\u23f3]|[\u23f8-\u23fa]|\ud83c\udccf|\u2934|\u2935|[\u2190-\u21ff])/g;
const inputStr: string = input.replace(deleteEmojiRegex, '');

2.utf8mb4 설정

my.cnf(리눅스), my.init(윈도우) 설정 파일 수정한다.

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
skip-character-set-client-handshake

서버 재시작한 후 상태 확인

show variables like 'c%';

참고 사이트

• How to remove emoji code using javascript?
• [MariaDB] Setting utf8mb4 Character Set
• [MySQL] MySQL에서 Unicode 저장 시 이모지(emoji) 문제