새 홈 UI는 정상적으로 보였지만 Google 로그인, 관리자, 개인 프로필, 개인자료실과 Google Drive 같은 기존 기능이 보이지 않았습니다. 화면 개편 과정에서 기능이 삭제된 것이 아니라, 공개 라우팅이 기능이 적은 경량 서비스로 연결된 것이 원인이었습니다.
원인 확인
운영 서버에는 경량 FAMOS 서비스와 기존 풀스택 Farmers 서비스가 동시에 존재했습니다. 경량 서비스는 홈 화면 중심이었고, 풀스택 서비스에는 로그인·권한·개인자료실·게시판·Drive·관리자 API가 포함돼 있었습니다. 공개 Nginx upstream이 잘못된 서비스로 향하면서 기능이 사라진 것처럼 보였습니다.
복구 방법
기존 데이터와 인증 기능이 있는 풀스택 서비스를 다시 공개 upstream으로 연결했습니다. 이후 새 UI는 풀스택 원본 위에 합쳐 기능과 화면을 동시에 유지했습니다. 관리자 역할과 Google Client ID, 비로그인 API 보호 응답도 런타임에서 다시 확인했습니다.
완료 기준
로그인 버튼이 보이는 것만으로 끝내지 않고 Google 설정 응답, 프로필 진입, 개인자료실 API의 인증 보호, 관리자 API의 권한 보호, 운영 upstream까지 확인했습니다. 기존 데이터가 유지되는지도 관리자 역할 저장 상태로 확인했습니다.
재사용 체크리스트
- 새 UI를 어느 서비스 소스 위에 적용하는지 확인합니다.
- 화면과 API가 같은 배포 단위를 사용하는지 확인합니다.
- 인증·권한·개인데이터 기능은 배포 후 별도 검증합니다.
- 기존 기능 목록과 수정 후 기능 목록을 비교합니다.
실제 장애 원인, 복구 절차, 검증 기준과 재사용 체크리스트를 포함했습니다.
추가 분석: 화면 복구와 데이터 복구는 서로 다른 확인입니다
가벼운 공개 화면을 배포하면 첫 화면이 열리는지 빠르게 확인할 수 있지만 로그인과 개인자료실 같은 서버 기능의 존재를 보장하지 않습니다. 이번 기록은 풀스택 원본을 복구한 사례로 읽어야 하며 새 서버에서 모든 외부 연동이 검증됐다는 뜻으로 넓히지 않습니다. 페이지 응답, 로그인 흐름, 개인자료의 권한을 각각 다른 완료 기준으로 적는 것이 재발 방지에 도움이 됩니다.
운영 데이터가 있는 서비스에서 화면 복구를 위해 초기 데이터를 덮어쓰면 기존 글과 답글의 연결이 깨질 수 있습니다. 복구 전에 코드 버전과 데이터 백업을 확보하고, 복구 후에는 기존 글 식별자와 공개 상태를 읽어야 합니다. 실제 백업 파일이나 계정 정보를 공개 본문에 넣을 필요는 없습니다. 독자에게 필요한 것은 안전한 재현 순서와 확인 범위입니다.
직접 따라 해보기
누가 하나요?
실제 사이트 개선 과정을 읽고 자신의 작업에 적용할 작성자·운영자
찾아갈 곳
사례 게시판과 공개 검증 기록에서 현재 기록을 읽습니다.
그대로 복사할 것
문제와 발생 위치: 수정 전 상태: 바꾼 한 가지: 직접 확인한 화면 / 결과: 아직 확인하지 못한 부분: 다음 행동:
실행자가 직접 할 행동
- 문제의 실제 화면과 입력 조건을 기록합니다.
- 수정할 범위를 한 가지로 정하고 이전 상태를 보존합니다.
- 수정 후 원래 문제가 발생한 경로에서 결과를 읽습니다.
- 확인한 결과와 미검증 기능을 구분해 저장합니다.
끝났는지 확인하는 방법
원래 경로에서 문제가 해결되고 기존 데이터와 권한이 유지됐는지 확인한 범위만 완료로 기록합니다. 다른 서비스 연동은 별도 검증이 필요합니다.
추가 확인 자료와 한계
이 보강은 기존 사례의 원문을 보존하고 선택 이유·실패 분기를 추가한 AI 보조 편집입니다. 인간 작성 비율이나 업무 효율을 측정한 기록이 아닙니다. 추가 검증 기록에서 실제 함수 검사와 설명용 예시를 구분해 읽을 수 있습니다. 문제가 다시 발생하면 원문과 실제 화면을 대조하고 문의에 공개 가능한 최소 정보를 남겨주세요.
이 장애에서 구분한 복구 전후
| 진입 경로 | 복구 전 | 복구 후 기록 |
|---|---|---|
| 공개 홈의 프로필 | 경량 화면에서 기존 계정 기능을 찾기 어려움 | 풀스택 원본 위에 프로필·관리자 진입 기능을 유지 |
| 개인자료 API | 화면 응답만으로 서버 기능 여부를 판단할 수 없음 | 비로그인 요청의 인증 보호 응답을 대조 |
| Google 로그인·Drive | 버튼 유무와 연결 성공이 혼동될 수 있음 | 설정 응답과 실제 계정 로그인·업로드 시험을 별도 항목으로 구분 |
핵심은 새 화면의 완성도가 아니라 공개 요청이 어느 서비스에 도착했는지였습니다. 같은 홈이 열려도 인증·권한 API가 빠진 서비스라면 복구가 끝난 것이 아닙니다. upstream과 배포 소스를 먼저 대조한 뒤 프로필 경로와 보호 응답을 검사하는 순서가 이 사례의 재사용 포인트입니다.
이 표는 기존 복구 기록을 정리한 것입니다. 2026년 10월 8일 편집 과정에서 Google 계정 로그인이나 Drive 업로드를 새로 실행한 결과는 아닙니다. 개인자료실의 사적인 메모와 원본 파일은 공개 사례의 근거에 포함하지 않습니다.
2026-10-08 편집: 다른 사례와 반복되던 일반 문단을 이 장애의 서비스 경로·인증 보호·미검증 연동 항목으로 교체했습니다.
공유된 첨부파일이 없습니다.