<div id="readability-page-1" class="page"><div><p><a href="/sitemap/sitemap.xml">Sitemap</a></p><div><div><a href="https://play.google.com/store/apps/details?id=com.medium.reader&amp;referrer=utm_source%3DmobileNavBar&amp;source=---top_nav_layout_nav-----------------------------------------" rel="noopener follow">Open in app<svg width="10" height="10" viewBox="0 0 10 10" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.984835 8.48484C0.838388 8.63128 0.838388 8.86872 0.984835 9.01516C1.13128 9.16161 1.36872 9.16161 1.51517 9.01516L0.984835 8.48484ZM8.75 1.25H9.125C9.125 1.04289 8.95711 0.875 8.75 0.875V1.25ZM8.375 6.5C8.375 6.70711 8.54289 6.875 8.75 6.875C8.95711 6.875 9.125 6.70711 9.125 6.5H8.375ZM3.5 0.875C3.29289 0.875 3.125 1.04289 3.125 1.25C3.125 1.45711 3.29289 1.625 3.5 1.625V0.875ZM1.51517 9.01516L9.01516 1.51517L8.48484 0.984835L0.984835 8.48484L1.51517 9.01516ZM8.375 1.25V6.5H9.125V1.25H8.375ZM3.5 1.625H8.75V0.875H3.5V1.625Z" fill="currentColor"></path></svg></a><div><p><span data-dd-action-name="Susi presentation tracker global_nav"><a data-testid="headerSignInButton" href="https://medium.com/m/signin?operation=login&amp;redirect=https%3A%2F%2Fmoony211.medium.com%2F%25ED%258C%258C%25EC%259D%25B4%25EC%258D%25AC-%25ED%2583%2580%25EC%259E%2585-%25ED%259E%258C%25ED%258A%25B8-any%25EC%259D%2598-%25EB%25AC%25B8%25EC%25A0%259C%25EC%2599%2580-unknown%25EC%259C%25BC%25EB%25A1%259C-%25EA%25B0%2580%25EB%258A%2594-%25EB%25B2%2595-1d0dac14bd9a&amp;source=post_page---top_nav_layout_nav-----------------------global_nav------------------" rel="noopener follow">Sign in</a></span></p></div></div><div><div><a aria-label="Homepage" data-testid="headerMediumLogo" href="https://medium.com/?source=---top_nav_layout_nav-----------------------------------------" rel="noopener follow"><svg width="719" height="160" viewBox="0 0 719 160" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="wordmark-medium-desc"><desc id="wordmark-medium-desc">Medium Logo</desc><path d="M174.104 9.73376L174.319 9.68654V8.02097H130.39L89.6001 103.89L48.8105 8.02097H1.47153V9.68654L1.68401 9.73376C9.70237 11.5436 13.7732 14.2426 13.7732 23.9764V137.93C13.7732 147.664 9.68661 150.363 1.66825 152.173L1.45581 152.22V153.891H33.5738V152.226L33.3614 152.178C25.343 150.369 21.2722 147.669 21.2722 137.936V30.5862L73.6709 153.891H76.6427L130.568 27.1475V140.75C129.881 148.438 125.847 150.812 118.586 152.451L118.371 152.501V154.153H174.319V152.501L174.104 152.451C166.835 150.812 162.704 148.438 162.017 140.75L161.98 23.9764H162.017C162.017 14.2426 166.088 11.5436 174.104 9.73376ZM199.659 85.2223C200.574 64.7475 207.927 49.9698 220.265 49.7154C224.071 49.7783 227.263 51.0269 229.744 53.4295C235.016 58.5469 237.495 69.2406 237.112 85.2223H199.659ZM199.106 90.9928H264.679V90.7174C264.493 75.061 259.958 62.8826 251.213 54.5206C243.654 47.2944 232.462 43.318 220.706 43.318H220.443C214.342 43.318 206.859 44.7974 201.534 47.478C195.473 50.2846 190.127 54.4813 185.679 59.9895C178.518 68.8629 174.18 80.8551 173.125 94.3318C173.091 94.7357 173.062 95.1397 173.033 95.5436C173.005 95.9475 172.986 96.3095 172.968 96.6951C172.931 97.4164 172.902 98.1403 172.887 98.8669C172.86 100.031 172.853 101.204 172.874 102.384C173.584 132.908 190.072 157.301 219.357 157.301C245.062 157.301 260.032 138.51 263.764 113.288L261.878 112.624C255.321 126.18 243.544 134.395 230.14 133.393C211.843 132.024 197.826 113.471 199.098 90.998M338.82 132.357C336.669 137.458 332.181 140.265 326.167 140.265C320.152 140.265 314.654 136.136 310.749 128.635C306.552 120.582 304.344 109.199 304.344 95.7141C304.344 67.6485 313.073 49.4951 326.584 49.4951C332.241 49.4951 336.695 52.3016 338.82 57.1987V132.357ZM382.319 152.365C374.3 150.468 370.23 147.643 370.23 137.414V1.30884L321.514 15.6616V17.419L321.813 17.3954C328.533 16.8524 333.091 17.781 335.738 20.2256C337.81 22.1403 338.82 25.078 338.82 29.2118V47.8715C334.017 44.8052 328.304 43.3128 321.372 43.3128C307.313 43.3128 294.463 49.2328 285.196 59.9843C275.536 71.1895 270.429 86.5023 270.429 104.262C270.426 135.982 286.041 157.301 309.28 157.301C322.875 157.301 333.813 149.852 338.82 137.288V154.153H382.531V152.407L382.319 152.365ZM424.1 19.819C424.1 9.91474 416.632 2.44458 406.725 2.44458C396.866 2.44458 389.152 10.0774 389.152 19.819C389.152 29.5606 396.873 37.1934 406.725 37.1934C416.632 37.1934 424.1 29.7233 424.1 19.819ZM435.599 152.365C427.58 150.468 423.51 147.643 423.51 137.414H423.475V43.6354L379.761 56.1862V57.8911L380.024 57.9147C389.482 58.7567 392.071 62.0144 392.071 73.0675V154.153H435.822V152.407L435.599 152.365ZM547.612 152.365C539.594 150.468 535.523 147.643 535.523 137.414V43.6354L493.902 55.7718V57.482L494.148 57.5082C501.881 58.3213 504.115 61.7652 504.115 72.8682V132.147C501.537 137.249 496.7 140.278 490.841 140.483C481.338 140.483 476.105 134.064 476.105 122.41V43.638L432.391 56.1888V57.8911L432.653 57.9147C442.112 58.7541 444.703 62.0118 444.703 73.0675V123.237C444.681 126.739 444.985 130.236 445.613 133.681L446.4 137.104C450.101 150.366 459.798 157.301 474.99 157.301C487.858 157.301 499.137 149.335 504.105 136.871V154.182H547.819V152.435L547.612 152.365ZM717.43 154.153V152.404L717.217 152.354C708.517 150.348 705.128 146.565 705.128 138.864V75.0741C705.128 55.1843 693.957 43.3128 675.245 43.3128C661.605 43.3128 650.104 51.1947 645.676 63.4728C642.159 50.4629 632.037 43.3128 617.07 43.3128C603.924 43.3128 593.621 50.2505 589.201 61.9698V43.6433L545.487 55.68V57.3954L545.75 57.419C555.095 58.2479 557.797 61.6 557.797 72.3698V154.153H598.584V152.407L598.369 152.354C591.428 150.723 589.188 147.748 589.188 140.115V66.998C591.024 62.7095 594.725 57.6288 602.041 57.6288C611.127 57.6288 615.733 63.9239 615.733 76.3252V154.153H656.53V152.407L656.315 152.354C649.375 150.723 647.135 147.748 647.135 140.115V75.0662C647.152 72.634 646.959 70.2048 646.557 67.8059C648.504 63.1449 652.417 57.6288 660.032 57.6288C669.246 57.6288 673.723 63.7429 673.723 76.3252V154.153H717.43Z" fill="#242424"></path></svg></a></div><div><p><span data-dd-action-name="Susi presentation tracker new_post_topnav"><a data-testid="headerWriteButton" href="https://medium.com/m/signin?operation=register&amp;redirect=https%3A%2F%2Fmedium.com%2Fnew-story&amp;source=---top_nav_layout_nav-----------------------new_post_topnav------------------" rel="noopener follow"><div><svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M14 4C14.2761 4 14.5 3.77614 14.5 3.5C14.5 3.22386 14.2761 3 14 3V4ZM21 10C21 9.72386 20.7761 9.5 20.5 9.5C20.2239 9.5 20 9.72386 20 10H21ZM14 3H4V4H14V3ZM3 4V20H4V4H3ZM4 21H20V20H4V21ZM21 20V10H20V20H21ZM20 21C20.5523 21 21 20.5523 21 20H20V21ZM3 20C3 20.5523 3.44771 21 4 21V20H3ZM4 3C3.44772 3 3 3.44772 3 4H4H4V3Z" fill="currentColor"></path><path d="M17.5 4.5L9.04173 12.9583C9.01429 12.9857 8.99361 13.0192 8.98134 13.056L8.15811 15.5257C8.09297 15.7211 8.2789 15.907 8.47434 15.8419L10.944 15.0187C10.9808 15.0064 11.0143 14.9857 11.0417 14.9583L19.5 6.5M17.5 4.5L19.8232 2.17678C19.9209 2.07915 20.0791 2.07915 20.1768 2.17678L21.8232 3.82322C21.9209 3.92085 21.9209 4.07915 21.8232 4.17678L19.5 6.5M17.5 4.5L19.5 6.5" stroke="currentColor"></path></svg><p>Write</p></div></a></span></p></div><div><a data-testid="headerSearchButton" href="https://medium.com/search?source=---top_nav_layout_nav-----------------------------------------" rel="noopener follow"><div><svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill-rule="evenodd" clip-rule="evenodd" d="M4.09234 11.06C4.09234 10.1473 4.27211 9.24358 4.62138 8.40036C4.97065 7.55715 5.48258 6.79099 6.12795 6.14562C6.77332 5.50026 7.53948 4.98832 8.38269 4.63905C9.2259 4.28978 10.1297 4.11001 11.0423 4.11001C11.955 4.11001 12.8588 4.28978 13.702 4.63905C14.5452 4.98832 15.3114 5.50026 15.9567 6.14562C16.6021 6.79099 17.114 7.55715 17.4633 8.40036C17.8126 9.24358 17.9923 10.1473 17.9923 11.06C17.9923 12.9033 17.2601 14.671 15.9567 15.9744C14.6534 17.2778 12.8856 18.01 11.0423 18.01C9.19909 18.01 7.43133 17.2778 6.12795 15.9744C4.82457 14.671 4.09234 12.9033 4.09234 11.06ZM11.0423 3.01001C9.75141 3.01124 8.4797 3.32292 7.33449 3.91876C6.18929 4.51459 5.20418 5.37711 4.46226 6.43355C3.72034 7.48999 3.24337 8.70937 3.07159 9.98883C2.89981 11.2683 3.03825 12.5703 3.47525 13.785C3.91224 14.9997 4.63497 16.0915 5.58245 16.9683C6.52994 17.8451 7.6744 18.4812 8.9193 18.8229C10.1642 19.1646 11.473 19.2019 12.7353 18.9316C13.9977 18.6613 15.1765 18.0915 16.1723 17.27L19.9223 21.02C19.9727 21.078 20.0345 21.1251 20.1039 21.1582C20.1732 21.1913 20.2487 21.2098 20.3255 21.2125C20.4023 21.2152 20.4788 21.2021 20.5504 21.1739C20.6219 21.1458 20.6868 21.1032 20.7412 21.0488C20.7955 20.9945 20.8381 20.9295 20.8662 20.858C20.8944 20.7865 20.9075 20.71 20.9048 20.6332C20.9021 20.5563 20.8836 20.4809 20.8505 20.4116C20.8174 20.3422 20.7704 20.2804 20.7123 20.23L16.9823 16.5C18.0418 15.3483 18.7426 13.9128 18.999 12.3691C19.2554 10.8253 19.0564 9.24032 18.4261 7.80795C17.7959 6.37559 16.7618 5.15798 15.4504 4.30407C14.1391 3.45017 12.6072 2.997 11.0423 3.00001V3.01001Z" fill="currentColor"></path></svg><p><span>Search</span></p></div></a></div><div><p><span data-dd-action-name="Susi presentation tracker global_nav"><a data-testid="headerSignInButton" href="https://medium.com/m/signin?operation=login&amp;redirect=https%3A%2F%2Fmoony211.medium.com%2F%25ED%258C%258C%25EC%259D%25B4%25EC%258D%25AC-%25ED%2583%2580%25EC%259E%2585-%25ED%259E%258C%25ED%258A%25B8-any%25EC%259D%2598-%25EB%25AC%25B8%25EC%25A0%259C%25EC%2599%2580-unknown%25EC%259C%25BC%25EB%25A1%259C-%25EA%25B0%2580%25EB%258A%2594-%25EB%25B2%2595-1d0dac14bd9a&amp;source=post_page---top_nav_layout_nav-----------------------global_nav------------------" rel="noopener follow">Sign in</a></span></p></div></div></div><div></div></div></div>

Stories by 이상문 on Medium

파이썬에서 외부 API 응답이나 타입 정보가 없는 라이브러리를 다룰 때 typing.Any를 많이 사용한다. 당장 타입 에러를 없애고 개발을 진행할 수 있어서다. 하지만 이는 잠재적 버그를 코드 깊숙이 숨기는 행위다.
Any는 "이 변수는 무엇이든 될 수 있으니 타입 체커는 신경 쓰지 마라"는 선언과 같다. 정적 타입 검사의 이점을 스스로 포기하는 것이다. 다행히 더 안전한 대안이 있다.
1. Any는 타입 검사를 끄는 스위치다
Any를 사용하면 타입 체커는 해당 변수에 대한 모든 검사를 중단한다. 존재하지 않는 속성 참조, 엉뚱한 타입과의 연산, 인덱싱, 함수 호출 등 거의 모든 연산이 허용된다.
from typing import Any
def process_any(data: Any) -> None:
    print(data + "hello")      # 오류 없음
    print(data["key"])         # 오류 없음
    print(data())              # 오류 없음
    data.no_such_method()      # 오류 없음 -> 런타임에 충돌!
이 코드는 타입 검사를 통과하고, 런타임에 이르러서야 오류를 발생시킨다.
Any = “타입 검사 포기” (편하지만 위험)
2. 더 안전한 대안: Unknown
Unknown은 타입이 전혀 알려지지 않았으므로, 타입이 명확히 확인되기 전까지 어떤 연산도 허용하지 않는다.
# pyright/Pylance는 Unknown을 자동으로 인식한다 (import 불필요)
# 다른 환경에서는: from typing_extensions import Unknown
def process_unknown(data: Unknown) -> None:
    print(data + "hello")  # 오류: Operator "+" not supported
    print(data["key"])     # 오류: 인덱싱 불가
    print(data())          # 오류: 호출 불가
VS Code의 Pylance나 pyright를 사용한다면 별도 import 없이 Unknown을 바로 사용할 수 있다. 다른 환경에서는 typing_extensions에서 가져와야 한다.
Unknown = “타입을 반드시 확인하라” (불편하지만 안전)
3. 타입 좁히기(Type Narrowing)로 실용적으로 만들기
Unknown을 실용적으로 만드는 핵심 기술이다. isinstance 같은 조건 검사로 변수의 타입 범위를 구체화한다.
def process_unknown_safe(data: Unknown) -> None:
    if isinstance(data, str):
        print(data.upper())  # str로 좁혀져 안전
    elif isinstance(data, dict):
        print(data.get("key"))  # dict로 좁혀짐
조건을 달면 타입이 좁혀진다.
타입 좁히기는 Union이나 Optional 타입에도 사용되는 기본 기술이다. 예를 들어 name: str | None에서 if name is not None: 검사 후 문자열 메서드를 사용하는 것과 같은 원리다.
실무 예시: API 응답 처리
import requests
def fetch_user_data(user_id: int) -> str:
    response = requests.get(f"/api/users/{user_id}")
    data: Unknown = response.json()  # API 응답은 Unknown으로 처리
    
    # 타입 좁히기로 안전하게 처리
    if isinstance(data, dict):
        if "name" in data and isinstance(data["name"], str):
            return data["name"]
        return "Unknown user"
    
    return "Invalid response"
# 여러 타입 가능성 처리
def process_config(config: Unknown) -> dict[str, str]:
    result = {}
    
    if isinstance(config, dict):
        for key, value in config.items():
            if isinstance(key, str) and isinstance(value, str):
                result[key] = value
    elif isinstance(config, str):
        # JSON 문자열일 수 있음
        import json
        try:
            parsed = json.loads(config)
            if isinstance(parsed, dict):
                return process_config(parsed)
        except json.JSONDecodeError:
            pass
    
    return result
성능 고려사항
isinstance 검사는 런타임에 실행되므로 약간의 오버헤드가 있다. 하지만 대부분의 경우 이 비용은 무시할 수 있는 수준이다. 성능이 중요한 핫 패스(hot path)에서는 다음을 고려한다:
한 번 검사한 타입을 변수에 저장해 재사용
타입 검사 위치를 함수 진입점으로 이동해 반복 검사 방지
성능 측정 후 실제 병목인 경우에만 최적화
def process_items(items: Unknown) -> list[str]:
    # 진입점에서 한 번만 검사
    if not isinstance(items, list):
        return []
    
    result = []
    for item in items:
        if isinstance(item, str):
            result.append(item.upper())  # 반복문 내부에서 재검사 불필요
    
    return result
4. 도구별 지원 현황
Unknown은 아직 표준 typing 모듈에 포함되지 않았다. pyright에서 시작된 개념으로, 지원 여부는 도구에 따라 다르다.
https://medium.com/media/b1246f23611cd9dbbee433e43311fd83/href
상황별 선택 가이드
https://medium.com/media/4dc9b689fe5651153e9b6ebd947df8f0/href
5. Any에서 Unknown으로 마이그레이션
기존 코드를 안전하게 전환하는 단계별 가이드다.
1단계: 위험 지점 파악
# 기존 코드
def old_handler(data: Any) -> None:
    process(data["user"])  # 런타임 에러 가능성
타입 체커가 잡지 못하는 위험한 Any 사용처를 찾는다.
2단계: Unknown으로 전환
# 1차 수정: Any → Unknown
def new_handler(data: Unknown) -> None:
    process(data["user"])  # 타입 에러 발생!
Any를 Unknown으로 바꾸면 타입 체커가 에러를 표시한다.
3단계: 타입 좁히기 추가
# 2차 수정: 타입 가드 추가
def safe_handler(data: Unknown) -> None:
    if isinstance(data, dict) and "user" in data:
        user = data["user"]
        if isinstance(user, str):
            process(user)  # 안전!
적절한 타입 검사를 추가해 안전하게 만든다.
4단계: 타입 정의 개선 (선택)
# 3차 수정: 명확한 타입 정의
from typing import TypedDict
class UserData(TypedDict):
    user: str
    email: str
def typed_handler(data: Unknown) -> None:
    if isinstance(data, dict):
        # TypedDict로 변환 시도
        if "user" in data and "email" in data:
            typed_data: UserData = data  # type: ignore
            process(typed_data["user"])  # 완전히 타입 안전
가능하다면 구조를 명확히 정의한 타입을 사용한다.
점진적 전환 전략
한 번에 모든 Any를 바꾸지 말고 다음 순서로 진행한다:
외부 경계(API, DB)에서 들어오는 데이터부터 시작
버그가 자주 발생하는 핵심 로직 우선
새 코드부터 Unknown 적용
레거시는 리팩토링 시 점진적 전환
# 실전 예시: API 핸들러
def api_endpoint(request_body: Unknown) -> dict:
    # 1. 진입점에서 검증
    if not isinstance(request_body, dict):
        return {"error": "Invalid request body"}
    
    # 2. 필수 필드 확인
    if "action" not in request_body:
        return {"error": "Missing action field"}
    
    action = request_body["action"]
    if not isinstance(action, str):
        return {"error": "Invalid action type"}
    
    # 3. 이후 로직은 타입 안전
    if action == "create":
        return handle_create(request_body)
    elif action == "update":
        return handle_update(request_body)
    
    return {"error": "Unknown action"}
마무리
Any는 편리하지만 타입 안정성을 포기한다. Unknown과 타입 좁히기는 약간의 노력을 요구하지만, 런타임 버그를 사전에 방지한다.
도구가 지원한다면 Unknown으로 전환을 검토해보자. 초기 투자 비용은 있지만, 장기적으로 유지보수 비용을 크게 줄이고 코드 신뢰성을 높인다.
핵심 원칙: 타입을 모른다면 Any로 무시하지 말고, Unknown으로 명시하고 확인하라.

파이썬 타입 힌트: Any의 문제와 Unknown으로 가는 법

댓글