파일 권한으로 인한 배포 문제 사전 차단

혼자 개발할 때는 권한 문제를 자주 간과하기 쉽다. 하지만 운영 환경에서는 권한이 맞지 않으면 서비스 전체가 동작하지 않을 수 있다.

배포 전에 확인할 것

npm run build

빌드가 성공해도 권한 문제가 있으면 배포 후 실패할 수 있다. 다음을 미리 확인하자:

• 업로드될 파일들의 권한이 올바른가
• 생성되는 디렉토리의 소유자는 누구인가
• 실행 권한이 필요한 파일들은 +x로 설정되어 있는가

환경 간 권한 차이

로컬과 운영 환경의 권한 설정이 다를 수 있다:

• 로컬: 보통 개인 사용자 권한
• 운영: 웹 서버 사용자(nginx, www-data 등) 권한

테스트할 때 같은 사용자 권한으로 테스트하면 본 배포 후 발생하는 권한 문제를 미리 줄일 수 있다.

논리적인 확인 순서

문제 해결 시 고정된 순서를 따르자:

1. 로그를 먼저 보기 - 대부분의 경우 로그에서 권한 에러를 명확히 알 수 있다
2. 실제 파일의 권한 확인
3. 권한을 바꾼 후 재시도

한 번에 하나씩만 변경

여러 파일의 권한을 한 번에 바꾸지 말자. 한 파일 또는 한 디렉토리의 권한을 변경한 후 실제로 문제가 해결되었는지 확인한다.

작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어든다. 권한 관련 기록을 남겨두면 다음에 비슷한 문제가 나왔을 때 매우 빠르게 대응할 수 있다.