레거시 XML 인터페이스 — 신규 REST API 연동 경험
약 120초
경험 중심 — 오래된 시스템과 신규 API를 연결하면서 겪은 파싱 오류
팀 프로젝트에서 10년 된 XML 기반 내부 시스템과 새로 만든 REST API를 연동하는 작업을 맡았습니다. 처음에는 단순한 포맷 변환이라고 생각했지만, 레거시 쪽에서 XML 네임스페이스를 일관성 없이 사용하고 있어서 파서가 절반의 메시지에서 실패했습니다.
원인은 구버전 시스템이 XML 표준을 완전히 따르지 않은 데 있었습니다. 표준 XML 파서 대신 정규식으로 필요한 필드만 추출하는 방식으로 임시 해결했지만, 유지보수가 어렵다는 것을 알면서도 더 빠른 방법이 없었습니다.
결국 3주 뒤 레거시 팀과 협의하여 신규 출력 포맷을 표준 XML로 고치는 작업을 같이 진행했습니다. 레거시 연동은 상대 시스템을 바꾸는 협의 비용이 기술 구현보다 더 오래 걸린다는 것을 이때 처음 실감했습니다.
이 결의 특징
XML 네임스페이스 불일치가 파서 실패의 원인이었고, 정규식으로 필드를 직접 추출하는 우회책으로 대응했으며, 근본 해결에 레거시 팀과의 3주 협의가 필요했다는 순차적 진단을 했습니다.
이 결이 통하는 자리
기술 채무와 협의 비용의 균형을 판단해야 하는 자리에서, '상대 시스템을 바꾸는 게 기술 구현보다 오래 걸린다'는 현장 교훈이 의사결정을 좌우합니다.