brandonwie.dev
EN / KR
On this page
devops devopsbashshell-scripting

Bash set -e와 명령어 치환

set -e(에러 시 종료)를 사용할 때, 명령어 치환이 커스텀 에러 메시지와 함께 예상과 다르게 동작하는 경우.

• Updated March 22, 2026 • 2 min read

문제

set -e

# 실패 시 즉시 종료 - 커스텀 메시지가 절대 표시되지 않아요
AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
if [ -z "$AWS_ACCOUNT_ID" ]; then
    echo "Custom error message"  # 여기에 도달하지 않아요!
    exit 1
fi

set -e에서는 $(...) 안의 명령이 실패하면 스크립트가 그 줄에서 즉시 종료돼요. 커스텀 에러 처리 코드가 실행될 일이 없어요.

해결 방법

if 패턴을 사용해서 성공과 실패를 모두 캡처하면 돼요.

set -e

# 실패를 캡처하고 커스텀 에러 메시지를 표시할 수 있어요
if ! AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text 2>/dev/null); then
    echo "✗ Failed to get AWS account ID. Check AWS CLI configuration."
    echo "  Required permission: sts:GetCallerIdentity"
    exit 1
fi

# 빈 결과도 확인 (명령은 성공했지만 아무것도 반환하지 않은 경우)
if [ -z "$AWS_ACCOUNT_ID" ]; then
    echo "✗ AWS account ID is empty. Check IAM role/credentials."
    exit 1
fi

왜 동작하나

패턴set -e 동작커스텀 메시지
VAR=$(cmd)실패 시 즉시 종료표시 안 됨
if ! VAR=$(cmd)if가 실패를 캡처표시됨

if 문이 종료 상태를 “소비”해서 set -e가 트리거되는 걸 막아요.

핵심 포인트

  • set -e는 모든 명령 실패 시 종료해요
  • 명령어 치환 $(...)도 명령이에요
  • if 문은 조건부의 set -e 트리거를 방지해요
  • 커스텀 에러 메시지가 필요하면 항상 if 패턴을 사용하면 돼요

언제 사용하면 좋을까

시나리오추천 패턴
간단한 스크립트, 커스텀 에러 불필요VAR=$(cmd)로 충분
set -e를 쓰는 프로덕션 스크립트if ! VAR=$(cmd) 사용
실패 유형 구분 필요if 패턴 + -z 체크

Comments

enko