@RequestMapping만 붙인 타입은 Spring 6부터 컨트롤러가 아니다

2021년 강의의 v1·v2 컨트롤러를 Spring Boot 4.1로 옮기면 서버는 정상으로 뜨는데 요청마다 404를 돌려준다. v1은 인터페이스와 구현 클래스로, v2는 인터페이스 없는 클래스로 만들었고, 둘 다 @Controller 대신 @RequestMapping만 붙어 있다. 컴포넌트 스캔을 피하고 설정 클래스에서 직접 빈으로 등록하려는 선택이다. 등록을…

템플릿 콜백 패턴으로 감싸면 추적기를 ScopedValue로 옮길 수 있다

앞 글의 로그 추적기는 컨트롤러·서비스·리포지토리마다 try/catch 안에서 begin()과 end()를 부르고, 요청 하나의 호출을 묶는 트랜잭션 ID(DB 트랜잭션과는 관계없다)를 ThreadLocal에 두었다가 가장 바깥 호출이 끝날 때 remove()로 비운다. 계층마다 핵심 호출 한 줄을 추적 코드 여러 줄이 둘러싸고, 그 모양이 클래스마다…

Flue 대화 스트림은 offset으로 이어 받는다

안드로이드나 Flutter 앱처럼 JavaScript SDK를 쓸 수 없는 클라이언트에서 Flue 에이전트와 대화하려면 HTTP로 직접 붙어야 한다. 메시지를 POST하면 답 대신 202 접수 응답이 오고, 답은 그 응답에 실린 offset을 들고 Flue 대화 스트림을 읽어서 받는다. offset은 응답에서 받은 문자열을 저장해…

Flue 스킬·MCP·서브에이전트·샌드박스는 컨텍스트에 들어오는 방식이 다르다

Flue로 만든 고객 응대 에이전트에 스킬, 서브에이전트, MCP 서버, 샌드박스를 차례로 붙여 보면 useSkill, useSubagent, useMcpConnection, useSandbox 모두 에이전트 함수에 한 줄을 더하는 같은 모양이고, 조건문 안에 넣으면 상태에 따라 붙였다 뗄 수도 있다. 하지만 모델이 호출마다 받는 분량과 실제…

Flue durable 도구만 크래시 후 재실행된다

결제나 메일 발송을 맡은 도구가 도는 중에 서버가 죽으면, 서버가 돌아온 뒤 그 도구도 다시 실행될 거라고 기대하기 쉽다. Flue에서 크래시 뒤에 재실행되는 도구는 durable: true로 선언한 도구뿐이다. 일반 도구 호출은 결과를 알 수 없다는 오류로 마감되고, 모델이 그 오류를…

Flue 에이전트는 시스템 프롬프트를 반환하는 함수다

Flue로 첫 에이전트를 만들면 손이 가는 곳은 에이전트 코드보다 그 바깥이다. 에이전트는 시스템 프롬프트를 반환하는 함수 몇 줄로 끝나고, 대화 기록과 스트리밍, 중단된 작업의 복구는 Flue가 맡는다. 작성자에게 남는 일은 어디에 배포할지, 어떤 URL로 열지, 그 URL을 누구에게 열지를 정하는…

admin 서버를 9시간 멈춘 OOM은 5중 조인이 아니라 기간 없는 정산 엑셀 다운로드 한 건이었다

2026년 10월 12일, 정산 관리 API를 서비스하는 admin 서버가 새벽 4시 46분부터 오후 1시 50분까지 약 9시간 응답하지 않았다. 고객사 문의로 알았고, 원인은 힙 포화였다. 장애 공유 문서는 정산 화면의 5중 조인 쿼리가 주문 데이터를 대량으로 올려 힙을 채웠다고 적었다.…