CORS 오류 이해하기, 요청 전송과 응답 읽기 권한의 차이
페이지 정보

본문
브라우저에서 CORS 오류가 보이면 서버에 요청이 전혀 도착하지 않았다고 생각하기 쉽습니다. 하지만 요청 종류와 실패 단계에 따라 실제 요청이 전송되지 않았을 수도 있고, 서버가 응답했지만 페이지의 스크립트가 그 내용을 읽지 못했을 수도 있습니다.
이 차이를 알아야 서버 로그와 개발자 도구를 올바른 순서로 확인할 수 있습니다. 이 글은 CORS의 기본 역할과 출처, 사전 요청, 인증의 관계를 정리합니다.
예시 주소와 처리 상황은 개념 설명을 위한 가상 구성입니다.

AI 생성 삽화 · 개념 이해를 위한 AI 연출 이미지이며 실제 시스템 구성도나 측정 결과가 아닙니다.
핵심 정리
CORS는 브라우저에서 다른 출처의 응답을 스크립트에 공유할 조건과 관련된 규칙입니다. 전송·서버 처리·응답 읽기를 나누어 확인하며 인증이나 업무 권한 검사를 대체하는 장치로 사용하지 않습니다.
1. 출처는 주소의 경로보다 앞부분으로 구분합니다
일반적인 HTTP 주소의 출처는 스킴과 호스트, 포트의 조합으로 판단합니다. MDN의 동일 출처 정책 설명에 따르면 같은 서버 이름처럼 보여도 이 조합이 다르면 다른 출처일 수 있습니다.
설명용으로 https://app.example.com의 페이지가 https://api.example.com을 호출하면 호스트가 다릅니다. 반대로 같은 출처의 /orders와 /users처럼 경로만 달라진 경우는 경로 차이만으로 다른 출처가 되지 않습니다.
개발 환경에서 프런트엔드와 API가 서로 다른 포트를 쓰는 상황도 출처를 비교해야 합니다. 화면에 보이는 도메인 이름만 기억하지 말고 실제 요청 주소를 확인합니다.
프록시를 지나거나 다른 주소로 이동하는 경우에는 최종 요청 흐름도 살펴봅니다. 같은 회사가 운영한다는 사실은 브라우저의 출처 판단 기준이 아닙니다.
먼저 페이지의 출처와 API의 출처를 적어 두면 왜 브라우저가 다른 출처의 응답으로 취급하는지 설명하기 쉽습니다.
2. 서버 응답과 스크립트의 읽기 권한을 나눕니다
CORS 관련 조건을 만족하지 못하면 브라우저가 응답을 페이지 스크립트에 제공하지 않을 수 있습니다. 서버가 요청을 처리했다는 사실과 JavaScript가 응답 본문을 읽었다는 사실은 별개입니다.
MDN은 사전 요청 없이 전송되는 일부 요청도 응답을 스크립트와 공유하려면 서버의 허용이 필요하다고 설명합니다. 따라서 CORS 오류를 서버 작업이 취소됐다는 신호로 해석하면 안 됩니다.
설명용으로 브라우저 화면은 결과를 읽지 못했지만 서버 로그에는 요청 처리가 남는 상황을 생각할 수 있습니다. 이때 화면의 오류만 보고 같은 작업을 반복하면 서비스 로직에 따라 중복 문제가 생길 수 있습니다.
실제 처리 여부는 요청 식별자와 서버 기록으로 확인합니다. 네트워크 실패, HTTP 오류, 업무 처리 실패와 CORS 제한도 구별해야 합니다.
사용자에게 표시할 실패 상태와 개발자가 조사할 원인을 하나의 메시지로 뭉개지 않는 편이 진단에 도움이 됩니다.
3. 사전 요청은 필요한 경우에 먼저 수행됩니다
일부 다른 출처 요청에서는 브라우저가 실제 요청 전에 OPTIONS 방식의 사전 요청을 보냅니다. 이는 사용할 메서드와 헤더 등에 대한 허용 조건을 확인하는 흐름이며 모든 요청에 항상 발생하는 것은 아닙니다.
MDN의 사전 요청 설명은 브라우저가 이 절차를 자동으로 처리한다는 점을 다룹니다. 개발자 도구에서 OPTIONS만 보이고 실제 요청이 없다면 먼저 사전 요청의 응답을 확인합니다.
반대로 실제 요청이 보인다면 그 응답의 조건을 별도로 봐야 합니다. 설명용으로 사용자 정의 헤더가 추가된 뒤 동작이 달라졌다면 요청 형태가 바뀌었는지 확인할 수 있습니다.
OPTIONS라는 메서드 이름이 있다는 이유만으로 모든 요청이 정상 허용됐다고 판단하지 않습니다. 상태 코드뿐 아니라 요청한 조건과 서버가 답한 허용 범위가 맞는지 확인합니다.
사전 요청 결과는 캐시될 수 있으므로 매번 동일한 네트워크 항목이 보일 것이라고 기대하지 않는 것도 중요합니다.
4. 허용 헤더와 인증은 서로 다른 역할입니다
서버는 CORS 응답 헤더로 어떤 출처와 요청 조건에 응답을 공유할지 표현합니다. Fetch 표준은 이 프로토콜과 자격 증명을 포함한 요청의 조건을 정의합니다.
쿠키 같은 자격 증명이 관련되면 클라이언트의 전송 설정과 서버의 허용 조건을 함께 확인해야 하며, 허용 출처를 무조건 별표로 열면 해결된다고 생각해서는 안 됩니다. 자격 증명이 포함된 응답 공유에는 구체적인 조건이 적용됩니다.
그렇다고 출처를 허용한 것이 사용자의 로그인이나 업무 권한을 보장하는 것도 아닙니다. 서버는 해당 사용자가 그 데이터를 읽거나 작업할 권한이 있는지 별도로 판단해야 합니다.
CORS 설정을 접근 통제 전체로 이해하면 브라우저 밖의 호출이나 다른 보안 요구를 놓칠 수 있습니다. 개발 중에는 필요한 출처와 요청 범위를 명시하고 실제 인증 흐름이 어떤 단계에서 처리되는지 확인합니다.
민감한 쿠키나 토큰 값을 오류 보고서에 그대로 복사하지 않고 필요한 메타정보로 조사합니다.
5. 브라우저 밖에서 성공한 결과와 비교할 때 주의합니다
서버에서 직접 호출하거나 명령줄 도구로 응답을 받았다고 브라우저에서도 같은 방식으로 읽을 수 있다는 뜻은 아닙니다. 브라우저의 출처 기반 제한과 서버 간 통신은 같은 검사 환경이 아닙니다.
두 결과를 비교할 때는 주소뿐 아니라 메서드와 헤더, 인증 조건도 같았는지 확인합니다. 개발용 프록시를 사용해 동작하게 만들었다면 실제 배포 경로에서도 같은 구조인지 별도로 살펴봅니다.
로컬에서 오류가 사라졌다는 사실만으로 운영 설정이 검증됐다고 판단하지 않습니다. 브라우저 보호 기능을 끄는 방식은 정상 사용자의 조건을 재현하지 못하므로 서비스 해결책으로 삼지 않습니다.
화면 스크립트에서 서버의 허용 응답 헤더를 임의로 대신 설정할 수 있다고 생각하지도 않습니다. 응답을 만드는 서버나 중간 계층의 실제 설정을 확인해야 합니다.
여러 계층이 헤더를 추가하는 환경이라면 최종 브라우저가 받은 응답을 기준으로 중복이나 누락을 살펴봅니다.
6. 실패 단계를 나누어 재현 기록을 만듭니다
조사 기록에는 페이지 출처, 실제 요청 주소, 메서드, 필요한 헤더 이름, 자격 증명 사용 여부를 적습니다. 비밀값은 제외하고 개발자 도구에서 사전 요청과 실제 요청이 각각 있었는지 표시합니다.
각 단계의 상태 코드와 관련 응답 헤더를 확인한 뒤 서버 기록과 요청 식별자를 연결합니다. 설명용 표를 전송 전, 사전 요청, 실제 처리, 응답 읽기, 화면 표시의 다섯 단계로 만들면 어떤 사실이 확인됐는지 나누기 쉽습니다.
서버에서 오류 응답을 만드는 경로에도 필요한 CORS 처리가 적용되는지 살펴볼 수 있습니다. 정상 응답만 확인하면 실제 장애 상황에서 원래 오류가 가려질 수 있기 때문입니다.
수정 후에는 허용한 출처의 정상 동작과 허용하지 않은 조건의 제한을 함께 확인합니다. 로그인 상태에 따른 차이가 있다면 그 조건도 분리합니다.
이렇게 기록하면 막연히 CORS를 풀어 달라는 요청 대신 어느 응답 단계의 어떤 조건을 맞춰야 하는지 구체적으로 전달할 수 있습니다.
7. 자주 묻는 질문
Q1. CORS 오류면 서버는 아무 작업도 하지 않았나요?
그렇게 단정할 수 없습니다. 사전 요청 단계에서 막혔는지 실제 요청이 처리된 뒤 읽기가 제한됐는지 구분해 확인합니다.
Q2. 주소의 경로가 다르면 다른 출처인가요?
일반적인 HTTP 주소에서는 스킴·호스트·포트 조합을 봅니다. 같은 출처에서 경로만 다른 것은 그 자체로 출처가 달라지는 조건이 아닙니다.
Q3. OPTIONS가 항상 먼저 보이나요?
모든 요청에 사전 요청이 필요한 것은 아닙니다. 요청 조건과 캐시 여부를 함께 확인해야 네트워크 기록을 해석할 수 있습니다.
Q4. CORS를 허용하면 로그인 검사도 끝난 것인가요?
응답 공유 조건과 사용자 인증·업무 권한은 별개입니다. 서버는 필요한 인증과 권한 검사를 별도로 수행해야 합니다.
참고 자료
- 이전글쿠버네티스 Job과 CronJob, 작업 완료와 예약 실행을 나누어 보기 26.10.05
- 다음글Python asyncio의 await, 기다림과 병렬 실행을 구분하기 26.10.03
댓글목록
등록된 댓글이 없습니다.