개발에 AtoZ까지

명절이면 택배 물량이 확 늘어납니다. 국토교통부가 잡은 올해 추석 택배 특별관리기간은 9월 7일부터 10월 2일까지 4주간이고, 평소 하루 1,840만 상자이던 물량이 1,930만 상자까지 오를 것으로 봤습니다.물량이 몰리면 사고도 늘죠. 그런데 택배가 없어졌을 때 얼마를 받을 수 있는지는 보내기 전에 운송장에 한 줄을 적었느냐로 갈립니다.흔히 "택배 분실은 무조건 50만원까지"라고 알려져 있는데 정확하지 않습니다. 50만원은 운송장에 물건값을 안 적었을 때의 한도입니다. 값을 적고 할증요금 2,000원을 더 내면 한도가 100만원으로 올라갑니다. 80만원짜리 한우 세트라면 2,000원 차이로 30만원을 더 받는 셈이죠.이 글에서는 상황별로 얼마를 받는지 계산식과 함께 정리하고, 놓치기 쉬운 기한 두 개..

Spring Boot 4로 올리고 나면 테스트는 대체로 그대로 돌아갑니다. @Test도 @ParameterizedTest도 손댈 게 없죠. 그래서 "JUnit도 알아서 최신이 됐겠지" 하고 넘어가기 쉽습니다.그런데 확인해 보면 그렇지 않습니다. Spring Boot 4.1.1이 고정하고 있는 JUnit 버전은 6.0.3이고, JUnit 공식 보안 정책의 지원 버전 표에는 6.1.x와 5.14.x만 있습니다. 6.0.x 행은 아예 없습니다.즉 Boot 4로 올린 팀은 자기도 모르게 보안 패치 대상이 아닌 JUnit 라인 위에서 테스트를 돌리고 있습니다. 이 글에서는 그 상황을 어떻게 정리할지와, JUnit 6으로 넘어갈 때 실제로 깨지는 두 곳을 짚습니다.직접 마이그레이션한 경험이 아니라 JUnit 릴리스..

추석 승차권을 잡아 두긴 했는데 일정이 아직 확실하지 않은 분들이 계실 겁니다. 취소하면 얼마를 떼일지 몰라서 그냥 들고 계신 경우도 많고요.먼저 좋은 소식부터 말씀드리면, 결제한 날을 포함해 7일 안에 취소하면 400원도 안 냅니다. 그리고 흔히 알려진 "명절엔 취소 수수료를 몇 배로 뗀다"는 이야기는 지금 기준으로는 사실이 아닙니다. 2025년 5월에 약관이 바뀌면서 명절 요율과 주말 요율의 숫자가 같아졌거든요.대신 명절에는 다른 게 바뀝니다. 평소라면 수요일·목요일 출발 표는 출발 3시간 전까지 취소해도 공짜인데, 이번 추석 특별수송기간에는 그 무료 구간이 아예 없습니다.이 글을 다 읽으면 내 승차권의 위약금을 원 단위까지 계산할 수 있고, 언제까지 취소해야 손해가 가장 적은지 알 수 있습니다.한국..

Spring Boot 3.5의 무상 지원이 6월 30일에 끝났습니다. 3.4는 작년 말에 이미 끝났으니, 지금 3.x에 있는 프로젝트는 무상 보안 패치를 받는 세대가 하나도 없는 상태입니다.그래서 4로 올리려고 릴리스 노트를 열어 보면 예상 못 한 문장이 나옵니다. JSON 라이브러리가 Jackson 3으로 바뀌었고, 패키지 이름이 com.fasterxml.jackson에서 tools.jackson으로 이동했다는 내용이죠. import 문을 전부 고쳐야 하나 싶어집니다.결론부터 말씀드리면 일괄 치환하면 두 군데에서 틀립니다. 그리고 springdoc-openapi로 API 문서를 만드는 팀은 지금 시점에 Jackson 3으로 못 갑니다. 이 글에서는 그 경계를 정리합니다.직접 마이그레이션한 경험이 아니라..

2학기 등록금 고지서를 받아 두고 미뤄 두셨다면 오늘이 마지막 날입니다. 2026년 2학기 국가장학금 2차 신청은 오늘 9월 9일 수요일 18시에 닫힙니다.그런데 재학생이라면 여기서 한 가지를 더 알고 누르셔야 합니다. 2차 신청은 1차를 놓친 사람에게 그냥 열어 주는 창구가 아니라, 재학 중 딱 두 번만 쓸 수 있는 구제신청을 자동으로 소모하는 절차입니다. 오늘 신청하면 그 두 번 중 한 번이 켜집니다.이 글을 다 읽으면 세 가지가 정리됩니다. 오늘 몇 시까지 무엇을 끝내야 하는지, 내 소득구간이면 한 학기에 얼마가 나오는지, 그리고 신청하고도 못 받는 경우가 무엇인지입니다.한국장학재단 2026년 2학기 국가장학금 공고와 재단이 공개한 학자금 지원구간표를 확인해 정리했습니다(확인일 2026년 9월 5일..

새로 합류한 팀원에게 "일단 로컬에 MySQL 깔고요, 포트는 3307로 바꾸고, 계정은…"이라고 설명하고 있다면 정리할 때가 된 겁니다. 그리고 CI에서만 실패하는 테스트가 있다면 원인은 대개 로컬과 CI의 DB가 다르다는 것이죠.Spring Boot 3.1부터 이걸 해결하는 기능이 두 개 들어왔습니다. Docker Compose 지원과 Testcontainers 지원입니다. 둘 다 @ServiceConnection이라는 같은 장치로 붙어서 접속 정보를 자동으로 채워 줍니다.그래서 질문은 "둘 중 뭐가 좋냐"가 아니라 "어디에 무엇을 쓰냐" 가 됩니다. 이 글에서 그 경계를 정합니다. Spring Boot 공식 레퍼런스를 확인해 작성했습니다(확인일 2026-08-30).개발 시점과 테스트 시점에 컨테이..

추석 연휴 고속도로에서 제일 답답한 순간은 옆 차로가 텅 비어 보일 때입니다. 버스전용차로가 뻥 뚫려 있고, 갓길로 몇 대가 슬쩍 빠져나가고, 1차로에 붙어 계속 달리는 차도 있죠.세 가지 다 단속 대상이고, 금액과 벌점이 꽤 다릅니다. 1차로 계속 주행은 4만 원에 벌점 10점인데, 버스전용차로와 갓길은 벌점이 30점입니다. 벌점 30점은 두 번이면 면허정지 구간에 들어갑니다.이 글을 다 읽으면 세 가지가 정리됩니다. 첫째, 세 위반의 금액과 벌점을 정확히 알 수 있습니다. 둘째, 우리 차가 버스전용차로를 탈 수 있는지 판단할 수 있습니다. 셋째, 1차로를 언제 써도 되는지 기준을 잡을 수 있습니다.도로교통법과 시행령·시행규칙, 법제처 찾기쉬운 생활법령정보를 확인해 정리했습니다(확인일 2026-08-3..

프런트 개발자에게 "API 문서 보고 만들었는데 응답이 다르게 와요"라는 메시지를 받은 적이 있으실 겁니다. 문서에는 createdAt이 있는데 실제 응답에는 없거나, 필수라던 필드가 사실은 선택이거나.이건 도구를 잘못 써서 생기는 문제가 아니라 어떤 방식으로 문서를 만드느냐에서 갈리는 문제입니다. 애너테이션으로 만든 문서는 코드가 바뀌어도 그대로 남고, 테스트로 만든 문서는 코드가 바뀌면 빌드가 깨집니다.이 글에서는 springdoc-openapi와 Spring REST Docs 중 무엇을 고를지, 그리고 둘을 합치는 방법까지 정리합니다. Spring REST Docs와 springdoc 공식 문서를 확인해 작성했습니다(확인일 2026-08-30).실행 중인 애플리케이션에서 뽑는 방식과 테스트에서 뽑는..