HOHYEON.DEV — 개발 노트
막혔던 문제를,
원인부터 해결까지 남깁니다.
직접 겪은 에러와 삽질을 한 편씩 정리하는 블로그입니다. 전체 노트와 바로 실행해 보는 강좌, 막힐 때 묻는 도와줘요는 dev.meokko.com에서 볼 수 있습니다.
글 주소에 한글 slug를 쓰기로 했습니다. 영문 제목은 멀쩡한데 한글 제목만 두 곳에서 깨졌습니다. 첫째, 저장 뒤 상세 페이지로 보내는 Server Action이 죽었습니다.export async function createPost(formData: FormData) { const slug = await savePost(formData); redirect(`/posts/${slug}`);}서버 로그TypeError [ERR_INVALID_CHAR]: Invalid character in header content ["x-action-redirect"]둘째, 그 글을 주소로 직접 열면 404였습니다. DB에는 분명히 그 slug가 있었고, lint·typecheck·build는 전부 통과한 상태였습..
조회 메서드에 @Transactional(readOnly = true)를 붙였습니다. 팀에는 두 가지 믿음이 있었습니다."이제 이 메서드에서는 절대 쓰기가 안 된다""붙이기만 하면 어디서든 성능이 좋아진다"실제로는 다른 서비스에서 호출되면 아무 효과가 없었고, 어떤 코드는 readOnly 트랜잭션 안에서도 데이터를 수정하고 있었습니다.잠깐, 이 경우 list()는 읽기 전용일까요?@Transactional // 읽기-쓰기 트랜잭션 시작public void order() { postService.list(1); // @Transactional(readOnly = true)}readOnly를 붙였으니 읽기 전용일 것 같지만, 아닙니다. 이미 진행 중인 읽기-쓰기 트랜잭션에 참여할 뿐..
릴리스 버전을 git 태그에서 만들어 내는 스크립트가 CI에서만 실패했습니다. 같은 명령이 로컬에서는 멀쩡했습니다.CI 로그fatal: No names found, cannot describe anything.변경된 파일만 골라 검사하려고 넣은 git diff origin/main...HEAD도 CI에서는 빈 결과이거나 에러였습니다. 태그는 분명히 저장소에 있었는데 말입니다.잠깐, actions/checkout 기본값으로 받으면 CI에는?- uses: actions/checkout@v5# 커밋 ?개, 태그 ?개저장소 전체가 받아질 것 같지만, 기본값은 커밋 1개, 태그 0개입니다. git describe가 찾을 태그가 애초에 없었습니다.3줄 요약GitHub Actions의 checkout은 기본으로 얕은..
pip install beautifulsoup4는 분명히 성공했는데, 코드를 실행하면 모듈이 없다고 나옵니다.ModuleNotFoundError: No module named 'bs4'설치가 실패한 것이 아니라, 설치한 파이썬과 실행하는 파이썬이 서로 달랐습니다.핵심 요약pip과 python이 서로 다른 파이썬을 가리키면, 설치는 성공해도 import는 실패합니다.가상환경(venv)마다 패키지 폴더가 따로 있어서, 다른 환경에 설치한 패키지는 보이지 않습니다.설치 이름과 import 이름이 다른 패키지가 있습니다. (beautifulsoup4 → bs4, opencv-python → cv2)해결 방법실행할 파이썬으로 pip을 직접 부르면, 설치되는 곳과 실행하는 곳이 같아집니다.python -m pip ..
전역 변수로 쓰던 유틸 파일을 정리하려고 import 한 줄을 넣었습니다. 그랬더니 브라우저에서는 화면이 하얗게 비고, Node.js 배치 스크립트도 같은 에러로 죽었습니다.SyntaxError: Cannot use import statement outside a module에러 문장은 같지만, 브라우저와 Node.js에서 원인이 서로 다릅니다.핵심 요약import는 ES 모듈로 읽히는 파일에서만 쓸 수 있습니다.브라우저는 script 태그에 type="module"이 없으면 일반 스크립트로 읽습니다.Node.js는 .mjs 확장자이거나, 가장 가까운 package.json에 "type": "module"이 있어야 ES 모듈로 읽습니다.해결 방법브라우저에서는 script 태그에 type을 붙입니다.Nod..
체험 기간이 끝나기 하루 전에 안내 메일을 보내려고, 가입 시점에 setTimeout을 걸어 뒀습니다. 7일 체험은 정상이었는데, 30일 체험은 가입하자마자 메일이 바로 발송됐습니다. 에러 로그는 없었습니다.const delay = trialEndsAt.getTime() - Date.now() - ONE_DAY; // 약 29일setTimeout(() => sendTrialReminder(user.id), delay); // 1ms 뒤 실행됨핵심 요약setTimeout 지연 시간의 최대값은 2147483647ms(약 24.8일)입니다.Node.js는 이 값을 넘거나, 1보다 작거나, NaN이면 지연을 1ms로 바꿔 바로 실행합니다.며칠 단위 예약은 타이머 대신 DB에 발송 시각을 저장하고 ..
목록 줄 오른쪽 끝에 시간을 세로 가운데로 두고 싶었습니다. 왼쪽은 분류 줄과 제목 줄이 자동으로 두 행을 만들고, 시간은 두 행을 모두 차지하게 했습니다..row { display: grid; grid-template-columns: minmax(0, 1fr) auto;}.row time { grid-column: 2; grid-row: 1 / -1; align-self: center;}그런데 시간이 가운데가 아니라 첫 줄 높이 안에 갇혀 14px 위로 치우쳤습니다. 눈으로는 "살짝 위"로만 보여서 한참 지나쳤습니다.잠깐, -1은 어디를 가리킬까요?grid-row: 1 / -1; /* -1 = 마지막 줄? */"마지막 줄"이라고 외워 두기 쉽지만, 정확히는 명시적으로 선언한 그리드의 마지막 ..
디자인 시스템의 Input처럼 DOM 요소를 감싸는 컴포넌트는, 바깥에서 포커스를 주려면 ref를 통과시켜야 했습니다. 그래서 전부 forwardRef로 감쌌습니다.const MyInput = forwardRef(function MyInput({ placeholder }, ref) { return ;});컴포넌트마다 래퍼가 한 겹씩 늘고, displayName도 따로 챙겨야 했고, ref를 두 개 이상 내려보내야 할 때는 방법이 없었습니다.잠깐, React 19에서 이 코드는 동작할까요?function MyInput({ placeholder, ref }) { return ;}예전 버전이었다면 ref는 props에 들어오지 않아 undefined였지만, React 19에서는 그대로 동작합니다. forw..
쿼리 문자열이 이어 붙이기와 이스케이프로 뒤덮여 있어서, 실제 SQL이 무엇인지 읽으려면 머릿속에서 다시 조립해야 했습니다.String sql = "SELECT id, title\n" + " FROM dev_notes\n" + " WHERE status = 'published'\n" + " ORDER BY published_at DESC";줄 하나 추가할 때마다 따옴표와 +를 다시 맞춰야 했고, DB 툴에서 복사한 SQL을 그대로 붙여 넣을 수도 없었습니다. 그래서 Java 15부터 정식 기능이 된 텍스트 블록으로 바꿨습니다.잠깐, 이 코드는 컴파일될까요?String name = """Pat Q. Smith""";한 줄이니 괜찮을 것 같지..
소프트 삭제된 댓글을 30일 뒤 완전히 지우는 정리 작업을 만들었습니다. 답글이 남아 있는 댓글은 자리를 지켜야 하니, 자식이 없는 것만 고르는 조건을 넣었습니다.DELETE FROM commentsWHERE deleted_at 실행 결과ERROR 1093 (HY000): Table 'comments' is specified twice,both as a target for 'DELETE' and as a separate source for data별칭(reply)도 붙였고 문법도 맞는데, 실행하자마자 거부당했습니다.3줄 요약MySQL·MariaDB에서는 같은 테이블을 고치면서 서브쿼리로 읽을 수 없습니다.별칭을 붙여도 소용없고, UPDATE에서도 똑같이 막힙니다.먼저 SELECT로 고르고, 그다음 id로..
웹과 앱을 만들며 막혔던 순간을 기록합니다. 전체 노트와 강좌는 dev.meokko.com에서 이어집니다.
