AI가 만든 웹 코드가 이상하게 동작해요
AI가 작성한 코드를 붙인 뒤 화면·API·배포가 예상과 다르게 동작할 때 자주 반복되는 구현 실수를 분류하는 시작 가이드입니다.
#AI 코딩
AI가 생성한 코드의 실행과 배포 과정에서 생기는 문제를 다루는 태그입니다.
문제 해결 가이드
3개 문서AI가 만든 코드를 배포하기 전에 무엇을 확인해야 하나요?
AI가 작성한 코드를 배포하기 전에 존재하지 않는 API, 비밀값 노출, 입력 검증, 비동기 오류, 서버·브라우저 경계를 확인하는 시작 가이드입니다.
Prisma P2021·P2022 오류로 테이블·열이 없다고 나와요
Prisma P2021·P2022가 발생할 때 실행 환경, 실제 테이블·열, migration 기록과 배포 순서를 확인하는 방법을 설명합니다.
오류·증상
21개 문서배포된 클라이언트가 localhost API 주소를 호출함
AI가 생성한 fetch·axios 주소가 개발용 localhost로 고정되어 운영 브라우저에서 API를 호출하지 못하는지 확인합니다.
AI가 만든 낙관적 UI가 저장 실패 후에도 성공 상태로 남음
서버 저장 전에 화면을 성공 상태로 바꾼 뒤 요청이 실패해도 원래 값과 오류 상태로 되돌리지 않는지 확인합니다.
AI가 만든 서버 API가 클라이언트 검증만 믿고 입력을 처리함
브라우저 폼의 필수·형식 검사를 우회한 요청이 서버의 데이터베이스·외부 API·파일 처리까지 도달하는지 확인합니다.
AI가 만든 코드가 catch에서 오류를 무시함
catch 블록이 비어 있거나 오류를 성공 결과로 바꾸어 장애가 기록되지 않는지 확인합니다.
AI가 만든 클라이언트 번들에 서버 비밀값이 포함됨
API 키·토큰·데이터베이스 연결 문자열이 브라우저 번들·소스맵·네트워크 응답에 포함되었는지 확인합니다.
AI가 만든 화면이 API 대기 중 빈 화면으로 남음
데이터 요청 중·성공·실패 상태를 구분하지 않아 사용자가 빈 화면을 오류로 오해하는지 확인합니다.
AI가 만든 API가 화면 권한 검사만 하고 서버 요청을 보호하지 않음
버튼을 숨기거나 프런트엔드 라우트를 막았지만 직접 API를 호출하면 다른 사용자의 데이터에 접근할 수 있는지 확인합니다.
AI가 만든 UI를 키보드만으로 조작할 수 없음
클릭 가능한 요소가 키보드 포커스를 받지 못하거나 Enter·Space 동작을 제공하지 않는지 확인합니다.
Client Component를 async 함수로 선언함
use client가 있는 React·Next.js 컴포넌트를 async 함수로 만들어 Promise를 반환하는지 확인합니다.
LLM 실수 패턴 002: 없는 CLI 플래그 사용
없는 CLI 플래그 사용이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 003: 없는 설정 키 작성
없는 설정 키 작성이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 004: 없는 환경변수 참조
없는 환경변수 참조이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 005: 없는 DB 컬럼·테이블 참조
없는 DB 컬럼·테이블 참조이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 006: 없는 내부 모듈 import
없는 내부 모듈 import이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 008: 없는 에러 코드·예외 클래스 처리
없는 에러 코드·예외 클래스 처리이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 009: 존재하지 않는 버전 지정
존재하지 않는 버전 지정이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 010: 없는 테스트 유틸·매처 사용
없는 테스트 유틸·매처 사용이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 011: 프레임워크 버전 간 API 혼용
프레임워크 버전 간 API 혼용이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 012: 없는 SQL 함수·문법 사용
없는 SQL 함수·문법 사용이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 013: 없는 HTTP 헤더·상태 규약 가정
없는 HTTP 헤더·상태 규약 가정이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.
LLM 실수 패턴 014: 없는 파일 경로에 쓰기 시도
없는 파일 경로에 쓰기 시도이 실제 프로젝트에서 발생했을 때 공식 동작과 실행 결과를 비교해 원인을 좁히는 공개 진단 문서입니다.