바보야, 문제는 경계야

Context

소프트웨어 개발에서 함수 분리, 모듈화, 마이크로서비스 등 복잡성을 다루기 위해 경계를 만들지만, 경계 자체가 새로운 복잡성의 원천이 되는 아이러니가 발생한다. 호출자-피호출자 간 계약의 모호함, 인터페이스의 추상화 누수, 외부 의존성의 예고 없는 변경, 신뢰 경계의 보안 취약점 등 코드와 코드, 시스템과 시스템이 만나는 지점에서 대부분의 난제가 집중된다.

Technical Solution

• 호출자-피호출자 경계에서 null 반환 vs 예외 던지기 등 명확한 계약 설정으로 모호함 제거
• 인터페이스 경계에서 추상화 누수를 인식하고 숨겨진 복잡성이 경계를 통해 노출되는 패턴 감시
• 의존성 경계에서 외부 API·라이브러리의 예고 없는 변경에 대비한 격리 계층 구성
• 신뢰 경계에서 검증된 데이터와 미검증 데이터를 명확히 분리하고 서명 없는 웹훅 수신 등 보안 취약점 제거
• 비동기 지점 사이의 상태 변경 관리 및 분산 시스템에서의 순서 경계 재검토
• 조직 구조와 시스템 구조의 불일치(콘웨이의 법칙) 인식 및 정기적 동기화
• 경계 도입 전 "이 경계를 넘는 것은 무엇인가", "이 경계가 깨지면 무슨 일이 일어나는가", "이 경계는 누가 관리하는가" 세 가지 질문 반복
• 섣부른 경계 분리 자제 및 의식적이고 정기적인 재검토를 통한 분리와 통합의 반복

Key Takeaway

경계는 복잡성을 관리하기 위한 필수 요소지만, 경계 자체가 복잡성의 원천이 된다는 역설을 인식하고 각 경계에 대해 명확한 계약과 관리 책임을 정의하며 정기적으로 재검토하는 의식적 설계가 필수적이다.