이 가이드는 사용자가 직접 만든 앱에 로그인하는 경우를 다룹니다. Replit 계정 로그인 문제는 계정 및 접근을 참조하세요.
먼저 인증 시스템을 확인하세요
Agent에게 다음과 같이 물어보세요. “이 앱은 Replit Auth, Replit 관리형 Clerk Auth, 별도로 구성한 인증 제공자 중 무엇을 사용하나요?”
Clerk의 경우 Agent가 통합을 프로비저닝했는지, 아니면 자체 Clerk 계정의 자격 증명을 직접 제공했는지 확인하세요. 두 구성을 섞어 사용하지 마세요.
로그인 오류를 해결하려고 인증 테넌트를 삭제하거나 다시 만들지 마세요. 테넌트를 삭제하면 사용자 계정이 삭제될 수 있습니다. 기존 사용자를 위한 마이그레이션 계획 없이 제공자를 전환하거나 자격 증명을 교체하지 마세요.
Preview에서는 로그인되지만 게시 후에는 실패하는 경우
- Preview와 게시된 앱을 각각 테스트하세요. 정확한 실패 내용을 기록하세요.
- Clerk의 경우 의도한 개발 또는 프로덕션 환경이 선택되어 있는지 확인하세요.
두 환경의 사용자와 구성은 별개입니다.
- 게시된 앱에 필요한 인증 환경 변수가 있는지 확인하세요.
이름과 구성 상태를 점검하되, 값을 채팅에 붙여넣지 마세요.
- 자체 제공자를 사용하는 경우 허용된 오리진 및 콜백 URL을
게시된 정확한 호스트 이름 및 프로토콜과 비교하세요.
- 의도한 구성 변경 사항을 게시한 다음, 새 브라우저 세션에서 테스트하세요.
OAuth redirect_uri_mismatch의 경우 실제 리디렉션 URI를 제공자에 등록된 URI와 비교하세요. 콜백 경로를 추측하거나 우회책으로 와일드카드 접근을 추가하지 마세요.
소셜 로그인 제공자 하나만 실패하는 경우
활성화된 다른 로그인 방법을 테스트하여 실패 범위를 좁혀 보세요. 실패하는 제공자의 설정에서 환경, 도메인, 콜백 URI가 올바른지 확인하세요. 관리형 Clerk의 경우 대체 테넌트를 만들지 말고 Clerk Auth를 따르세요.
사용자가 누락된 것처럼 보이는 경우
무언가를 변경하기 전에 프로젝트, 인증 제공자, 환경을 확인하세요. 개발 계정이 있다고 해서 프로덕션에도 같은 계정이 있다는 뜻은 아닙니다. 복사하거나 리믹스한 프로젝트는 인증 구성이 다를 수 있습니다. 사용자가 코드와 함께 마이그레이션되었다고 가정하지 마세요.
커스텀 도메인 때문에 로그인 오류가 발생하는 경우
먼저 기본 게시 URL을 테스트하세요. 커스텀 도메인에서만 실패한다면 도메인 가이드를 따른 다음 인증 제공자의 도메인 구성을 확인하세요. 호스팅 DNS와 인증 DNS는 별개의 점검 대상입니다.
도메인이 이미 다른 인증 애플리케이션에 연결되어 있다고 표시되면, 관리형 통합은 지원팀에, 자체 관리형 통합은 해당 제공자에 문의하세요. 도메인을 해제하려고 기존 애플리케이션을 삭제하지 마세요.
인증 이메일이 도착하지 않는 경우
주소, 스팸 폴더, 의도한 환경에 계정이 있는지 확인하세요. 다시 시도하기 전에 오류 또는 요청 제한 메시지를 기록하세요. 코드를 연속으로 빠르게 요청하지 말고, 인증 코드를 지원팀과 공유하지 마세요.
여전히 실패하나요?
제공자와 관리 방식, 환경, 실패하는 로그인 방법, 영향을 받는 호스트 이름, 민감 정보를 제거한 오류, 시간대를 포함한 시각을 알려 주세요. 다른 방법은 작동하는지도 명시하세요. 토큰, 쿠키, 자격 증명, 사용자 목록은 포함하지 마세요. 지원 체크리스트를 사용하세요. 
