본문 바로가기
삵

쉘에서는 되는 배치 스크립트가 crontab에 걸면 command not found가 납니다

조회 3 · 댓글 1
영영웅문작성자2026년 10월 30일

배치 작업을 cron에 올리는데 같은 스크립트가 터미널에서는 정상 실행되고 cron으로만 실패합니다. 지난번 내부 ALB 붙던 그 서버와 같은 박스입니다.

환경은 Ubuntu 22.04, 야간에 데이터를 말아서 S3로 올리는 쉘 스크립트입니다. 손으로 bash /opt/batch/run.sh 하면 끝까지 잘 돌고 종료코드 0입니다. 그런데 crontab에 등록하면 중간에 멈추고 로그에 아래만 남습니다.

$ crontab -l
10 3 * * * /opt/batch/run.sh >> /var/log/batch/run.log 2>&1

# run.log
/opt/batch/run.sh: line 14: aws: command not found
/opt/batch/run.sh: line 18: jq: command not found

aws cli는 /usr/local/bin/aws, jq는 거기 같이 깔려 있고 java도 별도 경로에 있습니다. 로그인 쉘에서 which aws 하면 멀쩡히 잡힙니다.

$ echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/deploy/.local/bin

$ sudo -u deploy which aws
/usr/local/bin/aws

이미 해본 것은 스크립트에 실행권한 부여, 절대경로로 스크립트 호출, shebang을 #!/bin/bash로 명시한 것입니다. 그래도 cron에서만 저 두 명령을 못 찾습니다. 스크립트 본문은 손 안 대고 cron이 같은 환경으로 돌게 맞추고 싶은데, 같은 계정인데 왜 cron에서만 실행 환경이 달라지는지 짚어주실 수 있을까요.

나나크나로2026년 11월 2일

증상만 보면 "스크립트가 깨졌나" 싶지만, 원인은 스크립트가 아니라 cron이 띄우는 실행 환경입니다. 같은 deploy 계정이라도 cron 작업은 로그인 쉘을 거치지 않기 때문에 ~/.bashrc, ~/.profile, /etc/profile 같은 로그인 초기화 파일을 전혀 읽지 않습니다. 그래서 로그인 쉘에서 보이던 PATH가 cron에서는 통째로 사라집니다.

Ubuntu(vixie-cron 계열)의 crontab(5) 매뉴얼에 cron이 작업을 돌릴 때 세팅하는 기본 환경이 명시돼 있습니다. 원문은 "SHELL is set to /bin/sh, and LOGNAME and HOME are set from the /etc/passwd line of the crontab's owner. PATH is set to '/usr/bin:/bin'" 입니다. 즉 사용자 crontab에서 PATH는 기본값이 /usr/bin:/bin 딱 두 개뿐입니다.

질문자 환경을 대입하면 그림이 맞아떨어집니다. aws cli와 jq는 /usr/local/bin에 있는데, 이 경로가 cron 기본 PATH에 없으니 aws: command not found, jq: command not found가 나는 겁니다. 로그인 쉘 PATH에는 /usr/local/bin이 들어 있어서 손으로 실행하면 멀쩡히 잡히고, sudo -u deploy which aws도 (로그인 환경을 끼고 돌기 때문에) 잡히는 것이고요. shebang이나 실행권한, 스크립트 절대경로 호출은 이 문제와 무관해서 아무리 손봐도 증상이 그대로였던 것입니다.

스크립트 본문을 안 건드리고 cron 쪽만 맞추고 싶다고 하셨으니, crontab 상단에 PATH를 선언하는 방식이 가장 깔끔합니다. crontab 파일 안에 NAME = value 형식으로 환경변수를 넣으면 그 아래 작업들에 적용됩니다.

$ crontab -e

# 로그인 쉘에서 쓰던 PATH를 그대로 명시
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/deploy/.local/bin

10 3 * * * /opt/batch/run.sh >> /var/log/batch/run.log 2>&1

java도 별도 경로에 있다고 하셨는데, 스크립트가 java를 이름만으로 호출한다면 그 경로( 예: JDK bin 디렉터리 )도 위 PATH에 같이 넣어주셔야 같은 증상을 안 만납니다. 참고로 crontab 안의 PATH 값에는 $PATH 같은 쉘 변수 전개가 적용되지 않으니, 다른 변수를 참조하지 말고 전체 경로를 그대로 적어주세요.

스크립트를 조금 손대도 된다면 더 견고한 방법은 스크립트 최상단에서 PATH를 직접 export 하는 것입니다. 이러면 cron이든 수동이든 동일하게 돕니다.

#!/bin/bash
export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/deploy/.local/bin
# 또는 각 명령을 절대경로로: /usr/local/bin/aws ... , /usr/local/bin/jq ...

적용 전에 cron이 실제로 어떤 환경을 보는지 한번 찍어서 확인하시는 걸 권합니다. 임시로 아래 한 줄을 넣어두고 1분 뒤 파일을 보면 cron 기준 PATH가 그대로 보입니다.

* * * * * env > /tmp/cron-env.txt

# 비교
$ cat /tmp/cron-env.txt | grep -E 'PATH|SHELL|HOME'

여기서 PATH가 /usr/bin:/bin으로만 찍히면 이번 건과 동일한 원인이 확정됩니다. 확인 끝나면 그 테스트 줄은 지우시고요. 주의할 점으로, AWS 자격증명을 환경변수나 특정 프로필에 의존한다면 그것도 로그인 쉘 환경이라 cron에서 안 넘어올 수 있으니, PATH 고치고 나서 S3 업로드 단계에서 인증 에러가 또 나오는지 run.log를 같이 보시는 게 좋습니다.

참고 문서는 Ubuntu crontab(5) 매뉴얼입니다.

🔗 https://manpages.ubuntu.com/manpages/focal/man5/crontab.5.html

🔗 https://manpages.debian.org/buster/cron/crontab.5.en.html

로그인 후 답글을 남길 수 있습니다.