“화면은 다 됐는데요” AI 코딩 API 연동이 막히는 이유
화면 완성과 API 연결 사이에 빠진 약속을 찾습니다
예제 데이터로 움직이는 버튼부터 구분합니다
AI가 만든 화면은 그럴듯한데 저장한 내용이 새로고침 뒤 사라지나요? 버튼을 누르면 완료 안내까지 나오지만 다른 기기에서는 데이터가 보이지 않는다면, AI 코딩 결과가 실제 서버와 연결됐는지 먼저 확인해야 합니다.
예를 들어 할 일 목록이 코드에 적힌 예제 배열을 보여주고, 추가 버튼은 그 배열만 바꾸고 있을 수 있습니다. 이런 모의 데이터는 화면을 빠르게 만드는 데 유용하지만 실제 저장 기능이 완성됐다는 근거는 되지 않습니다. 코드 작성량을 줄이는 개발 방식이 궁금하다면 지식백과의 로 코드 항목을 배경 자료로 함께 살펴볼 수 있습니다.
AI에게 화면보다 먼저 연결 명세를 줍니다
- 작업을 하나만 고릅니다. 목록 조회, 항목 추가, 삭제를 동시에 연결하지 말고 우선 목록 조회 한 가지를 선택합니다. 실제 데이터 한 건을 화면에 표시하는 것을 첫 목표로 삼습니다.
- 요청 조건을 적습니다. API 문서에서 주소, 요청 방식, 인증 필요 여부, 필수 입력값을 확인합니다. 문서에 없는 경로를 AI가 추측했다면 서버 구현과 대조하기 전까지 확정하지 않습니다.
- 응답 예시를 맞춥니다. 서버가 items라는 항목 안에 목록을 보내는데 화면은 응답 전체를 배열로 읽으면 연결 후에도 표시되지 않습니다. 민감한 값을 지운 응답 예시와 화면에 필요한 필드를 함께 제공합니다.
API가 아직 없다면 서버 구현부터 필요한 상태입니다. 이때는 화면 작업과 서버 작업을 나누고, 모의 데이터를 사용하는 화면에는 개발 중임을 표시해 완성도를 오해하지 않게 합니다.
요청이 멈추는 지점을 세 단계로 좁힙니다
버튼 한 번에 어떤 요청이 나가는지 봅니다
브라우저 개발자 도구의 Network 탭을 연 뒤 목록 새로고침 버튼을 한 번 누릅니다. 해당 API 요청이 생기는지, 어느 주소로 가는지, 어떤 응답이 돌아오는지를 차례로 확인하면 프런트엔드와 서버 중 어디를 고쳐야 할지 좁힐 수 있습니다.
- 요청 자체가 없는 경우: 버튼 이벤트가 연결됐는지, 입력 검증에서 멈췄는지, 모의 데이터를 반환하는 분기가 남아 있는지 확인합니다. Network 탭의 필터 때문에 요청이 숨겨지지 않았는지도 살펴봅니다.
- 엉뚱한 주소로 가는 경우: 화면을 배포한 환경의 API 기본 주소와 경로를 확인합니다. 개발용 주소가 남았거나 주소 끝과 경로 앞에 같은 접두사가 중복됐는지 비교합니다. 환경변수 변경 후 재빌드가 필요한지는 사용 중인 도구의 설정 방식을 따릅니다.
- 서버에서 오류를 돌려주는 경우: 상태 코드만 보고 코드를 전부 바꾸지 말고 응답의 오류 설명과 서버 기록을 함께 읽습니다. 요청 시각과 요청 식별자가 있으면 같은 요청을 찾기 쉬우며, 공유할 때 인증 토큰과 개인정보는 제거합니다.
인증 실패와 CORS 오류는 수정 위치가 다릅니다
인증 정보가 빠진 문제는 해당 API가 요구하는 로그인 방식부터 확인해야 합니다. 반면 CORS 오류는 브라우저에서 다른 출처의 응답을 읽도록 허용했는지 살펴보는 문제입니다. 출처에는 도메인뿐 아니라 프로토콜과 포트도 포함됩니다. 이 동작은 [MDN의 CORS 설명](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS)을 근거로 구분할 수 있습니다.
| 관찰한 상황 | 우선 확인할 항목 |
|---|---|
| 로그인 뒤에도 인증 오류가 발생합니다 | API가 요구하는 토큰 또는 쿠키가 실제 요청에 포함됐는지 확인합니다. |
| 별도 API 호출 도구에서는 되지만 브라우저에서 막힙니다 | CORS 메시지와 서버의 허용 출처 설정을 확인합니다. 인증 조건 차이도 함께 비교합니다. |
| OPTIONS 요청에서 멈춥니다 | 사전 요청에 서버가 허용 출처·메서드·헤더를 적절히 응답하는지 확인합니다. |
연결 오류가 보인다고 브라우저 보안 기능을 끄는 방식으로 작업을 끝내면 실제 이용자의 환경에서는 여전히 실패할 수 있습니다. 호출 주소와 인증 조건을 맞춘 뒤, 서버 또는 API 제공자가 지원하는 방식으로 허용 출처를 설정합니다.
AI에게는 “API가 안 돼요”보다 “목록 조회 요청의 주소, 상태 코드, 비밀값을 지운 응답, 기대한 동작”을 묶어 전달하세요. 관찰한 사실과 추측을 구분하면 불필요한 수정이 줄어듭니다.
응답이 왔다고 저장 성공을 표시하지 않습니다
HTTP 성공과 화면에 쓸 데이터를 따로 판정합니다
요청이 도착했다는 사실만으로 저장 성공을 판단하면 안 됩니다. 자바스크립트의 fetch는 서버가 404 같은 HTTP 오류를 반환해도 그 이유만으로 실패 처리되는 구조가 아니므로, 응답 상태를 명시적으로 확인해야 합니다. 이 특성은 [MDN의 Fetch 사용 문서](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch)에서 확인할 수 있습니다.
상태를 확인한 다음에는 API가 약속한 응답 형식을 점검합니다. JSON을 기대했는데 로그인 화면의 HTML이 돌아왔거나, 본문이 없는 응답을 무조건 JSON으로 읽는 경우에도 문제가 생깁니다. 언어 자체가 낯설다면 지식백과의 자바스크립트 항목을 기초 용어 참고 자료로 활용하고, 구체적인 연결 조건은 사용 중인 API 문서에서 확인합니다.
사용자가 볼 네 가지 상태를 나눕니다
- 불러오는 중: 조회가 진행되고 있음을 표시합니다. 저장 요청 중에는 버튼을 잠시 비활성화해 같은 조작이 반복되는 것을 줄입니다.
- 정상 데이터: 응답을 화면에 필요한 형태로 변환합니다. 서버 필드 이름이 title이고 화면에서 name을 사용한다면 연결 함수에서 대응 관계를 명시합니다.
- 정상적인 빈 결과: 조회에 성공했지만 항목이 없을 때만 “등록된 항목이 없습니다”라고 안내합니다. 서버 오류를 빈 배열로 바꾸면 장애와 빈 목록을 구별할 수 없습니다.
- 실패: 저장되지 않았다는 사실과 다시 시도할 수 있는 방법을 표시합니다. 입력한 내용을 유지하면 사용자가 같은 내용을 처음부터 작성하는 불편을 줄일 수 있습니다.
AI에게 수정시킬 때는 “오류를 처리해 줘” 대신 어떤 응답에서 어떤 화면이 보여야 하는지 지정합니다. 예를 들어 조회 실패 시 기존 목록을 유지하고 재시도 버튼을 보여주도록 요구하면, 오류를 숨기기 위해 데이터를 비우는 변경을 발견하기 쉽습니다.
저장 버튼을 살린 뒤 다시 망가뜨리는 세 가지 실수
같은 요청을 반복하기 전에 저장 결과부터 확인합니다
목록 조회가 되면 항목 추가를 연결하고, 새로고침한 뒤에도 방금 저장한 항목이 나타나는지 확인합니다. 같은 계정으로 다시 접속해 확인하면 화면 안에서만 값이 바뀌는 상태를 걸러내는 데 도움이 됩니다. 수정 전후에 사용할 예제 입력값을 고정하면 달라진 동작을 비교하기도 쉽습니다.
이 단계에서 AI에게는 API 연결 함수와 해당 화면의 상태 처리처럼 수정 범위를 좁혀 요청합니다. 연결 문제를 고치는 동안 로그인 구조와 화면 전체를 함께 바꾸면 어느 변경이 효과가 있었는지 판단하기 어려워집니다.
오류가 안 보이는 상태를 성공으로 착각하지 않습니다
- 첫째, 실패하면 예제 데이터로 대체합니다. 시연 화면은 자연스러워져도 실제 연동 실패가 가려집니다. 개발용 모의 응답은 명확한 설정으로 분리하고, 실제 API를 확인할 때는 그 설정을 끈 상태에서 조회와 저장을 확인합니다.
- 둘째, 응답이 늦으면 저장을 계속 재시도합니다. 응답을 받지 못했더라도 서버에는 이미 저장됐을 수 있습니다. 먼저 목록이나 처리 결과를 조회하고, 반복 요청이 필요한 기능이라면 서버가 지원하는 중복 방지 방식과 요청 식별자 규칙을 확인합니다. 버튼 잠금만으로 모든 중복 저장이 방지되지는 않습니다.
- 셋째, 오류 안내만 지우고 완료 표시를 남깁니다. 실패 처리에서 메시지를 숨기거나 요청 직후 성공 알림을 띄우면 이용자는 저장됐다고 믿게 됩니다. API 계약상 저장 성공을 확인한 뒤에만 완료를 표시하고, 실패했을 때는 입력 내용을 보존하도록 수정합니다.

- 다음글AI 코딩 오류가 막막하다면 자바스크립트 콘솔부터 읽으세요 26.11.21
등록된 댓글이 없습니다.
