바꾸려는 동작
AsyncLocalStorage 컨텍스트에서 바꿀 결과와 유지할 기존 동작을 한 문장씩 적습니다. AsyncLocalStorage는 지원되는 async chain에서 context를 전달하지만 잘못 promisify한 callback이나 별도 native 경계에서 유실될 수 있습니다.
핵심 원리
기대 결과와 실제 결과를 나누고 둘이 달라지는 가장 작은 입력·설정·상태를 찾습니다. 확인하지 않은 원인을 사실처럼 단정하지 않습니다. 현재 version의 공식 문서와 실제 설정을 확인하고 대표·경계·실패 사례를 준비합니다. event loop delay/utilization, CPU profile, heap/RSS, active handle, GC와 dependency latency를 함께 본다.
| 순서 | 할 일 |
|---|---|
| 1 | 수정 전 결과와 되돌릴 기준 저장 |
| 2 | 핵심 사실과 맞닿은 한 곳만 변경 |
| 3 | 같은 입력으로 수정 전후 비교 |
단계별 적용 예시
확인된 원인과 직접 맞닿은 코드나 설정만 우선 수정합니다. 주제와 무관한 추상화나 운영 장치를 함께 추가하지 않습니다. CPU 작업과 I/O를 구분하고 queue, timeout, body, 동시성에 제한을 둔 뒤 정상 종료를 구현한다. 예상과 다르면 변경을 더 얹지 말고 처음 달라진 값으로 돌아갑니다. 부하 테스트에서 처리량, p99, event loop delay, heap 기준선, 열린 handle과 종료 시간을 검증한다. 주제에 맞는 정상·경계·실패 조건을 다시 실행하고 수정 전 재현 사례가 사라졌는지 확인합니다.
공식 문서와 적용 범위
문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 runtime·framework version, 실제 입력과 요청 흐름에서 다시 확인합니다.