Bash สัญญาณและ trap



สคริปต์ที่ดีต้อง “เก็บกวาด” ตัวเองเสมอ — ลบไฟล์ชั่วคราว ปิด connection คืนสถานะ แม้จะถูกกด Ctrl+C กลางคัน trap คือเครื่องมือสำหรับเรื่องนี้

สัญญาณ (signal) คืออะไร

สัญญาณคือ “การแจ้งเตือน” ที่ระบบส่งให้ process — บอกว่าเกิดอะไรขึ้นและอยากให้ทำอะไร

signalเลขเกิดเมื่อพฤติกรรมปริยาย
SIGINT2กด Ctrl+Cจบ process
SIGTERM15kill <pid> (ปกติ)จบ process (แบบสุภาพ)
SIGKILL9kill -9จบทันที — trap ไม่ได้
SIGHUP1terminal ปิดจบ process
SIGQUIT3Ctrl+\จบ + core dump
SIGTSTP20Ctrl+Zหยุดชั่วคราว
EXIT—(bash) สคริปต์จบไม่ว่าด้วยเหตุใด—
ERR—(bash) คำสั่งคืน non-zero—

SIGKILL (9) และ SIGSTOP ดักไม่ได้ — เป็นทางออกสุดท้ายของระบบเสมอ

trap พื้นฐาน

trap 'echo "ได้รับ Ctrl+C — กำลังหยุด"; exit 130' INT

echo "กำลังทำงาน... กด Ctrl+C ดู"
sleep 60

รูปแบบ: trap 'คำสั่ง' SIGNAL [SIGNAL...]

  • คำสั่งครอบด้วย '...' (single quote) — เพื่อให้ตีความตอน trap ทำงาน ไม่ใช่ตอนตั้ง
  • ระบุได้หลาย signal: trap 'cleanup' INT TERM HUP
  • ใช้ชื่อ (INT) หรือเลข (2) — ชื่ออ่านง่ายกว่า

trap EXIT — ทำความสะอาดเสมอ

trap ที่สำคัญที่สุด — EXIT ทำงานตอนสคริปต์จบ ไม่ว่าด้วยเหตุใด: จบปกติ, exit, error (กับ set -e), หรือถูก signal (ถ้า trap signal นั้นแล้ว exit)

#!/usr/bin/env bash
set -euo pipefail

tmpdir=$(mktemp -d)
trap 'rm -rf "$tmpdir"' EXIT              # ← ลบ tmpdir ตอนจบเสมอ

echo "ใช้ tmpdir: $tmpdir"
curl -fsS "$url" -o "$tmpdir/data.json"
process "$tmpdir/data.json"
# ไม่ต้อง rm เอง — trap จัดการ แม้ process จะ error กลางคัน

นี่คือ ท่ามาตรฐาน สำหรับไฟล์ชั่วคราว — ตั้ง trap ทันทีหลังสร้าง ไม่ต้องกังวลว่าจะออกทางไหน

trap หลาย signal + cleanup function

#!/usr/bin/env bash
set -euo pipefail

readonly LOCKFILE="/var/run/myjob.lock"
readonly TMPDIR=$(mktemp -d)

cleanup() {
    local rc=$?
    rm -rf "$TMPDIR"
    rm -f "$LOCKFILE"
    (( rc != 0 )) && echo "สคริปต์จบด้วยข้อผิดพลาด (rc=$rc)" >&2
    exit "$rc"
}
trap cleanup EXIT INT TERM

echo $$ > "$LOCKFILE"
# ... งานหลัก ...

local rc=$? บรรทัดแรกของ cleanup — เก็บ exit status ก่อนที่คำสั่งใน cleanup จะทับ

trap ERR — รายงานตำแหน่งที่พัง

#!/usr/bin/env bash
set -Eeuo pipefail                       # -E ให้ trap ERR ทำงานในฟังก์ชันด้วย

trap 'echo "ERROR ที่บรรทัด $LINENO: คำสั่ง \"$BASH_COMMAND\" คืน $?" >&2' ERR

echo "เริ่ม"
false                                    # ← trap ERR ทำงาน แล้ว set -e จบสคริปต์
echo "ไม่ถึงตรงนี้"
เริ่ม
ERROR ที่บรรทัด 8: คำสั่ง "false" คืน 1
  • set -E (หรือ -o errtrace) จำเป็น — ไม่งั้น trap ERR ไม่ทำงานในฟังก์ชัน/subshell
  • $BASH_COMMAND = คำสั่งที่กำลังรัน, $LINENO = บรรทัด
  • ใช้คู่กับ set -e — ERR trap รายงาน แล้ว set -e จบสคริปต์

reset และ ignore trap

trap - INT                       # คืนพฤติกรรมปริยายของ INT
trap - EXIT                      # ยกเลิก EXIT trap (เช่น ไม่อยากให้ cleanup ทำงานแล้ว)
trap '' INT                      # เพิกเฉย INT (Ctrl+C ไม่มีผล — ระวังใช้!)

# ตัวอย่าง: ป้องกันช่วง critical ไม่ให้ถูกขัด
trap '' INT TERM
critical_database_migration
trap - INT TERM                  # เปิดรับ signal คืน

trap '' SIG (สตริงว่าง) = ไม่ทำอะไรเมื่อได้ signal — ใช้กันงานสำคัญถูกขัดกลางคัน แต่อย่าลืมคืน

ท่า: ถาม cleanup เฉพาะตอน error

#!/usr/bin/env bash
set -euo pipefail

work_dir=$(mktemp -d)

on_exit() {
    local rc=$?
    if (( rc == 0 )); then
        rm -rf "$work_dir"           # สำเร็จ — ลบ
    else
        echo "ล้มเหลว — เก็บ $work_dir ไว้ debug" >&2
    fi
}
trap on_exit EXIT

ท่า: graceful shutdown ของ daemon-style script

#!/usr/bin/env bash
running=true
trap 'running=false' TERM INT

echo "เริ่ม worker (PID $$)"
while $running; do
    process_one_item || true
    sleep 1
done
echo "ได้รับสัญญาณหยุด — เก็บงานให้เรียบร้อยก่อนออก"
flush_pending
echo "ออกอย่างสะอาด"

kill -TERM $pid → loop จบรอบปัจจุบัน → ทำ flush → ออก (ไม่ใช่ตายกลางคัน)

timeout — จำกัดเวลาคำสั่ง

timeout 30 ./slow_command            # ฆ่าด้วย SIGTERM หลัง 30 วิ
timeout -k 5 30 ./stubborn_command   # TERM หลัง 30 วิ, ถ้ายังไม่ตายส่ง KILL อีก 5 วิ
timeout 10s curl -fsS "$url"

if timeout 60 ./deploy.sh; then
    echo "deploy เสร็จใน 60 วิ"
else
    rc=$?
    (( rc == 124 )) && echo "deploy timeout!" >&2      # 124 = timeout ฆ่า
fi

DEBUG trap — รันก่อนทุกคำสั่ง (debug)

trap 'echo "[บรรทัด $LINENO] $BASH_COMMAND"' DEBUG
# ทุกคำสั่งถูกพิมพ์ก่อนรัน — คล้าย set -x แต่คุมได้

เรื่องที่คนมักพลาด

  • ครอบคำสั่ง trap ด้วย double quote — trap "rm $tmpdir" EXIT แทนค่า $tmpdir ตอนตั้ง (ยังว่าง) ใช้ single quote
  • ลืม set -E กับ trap ERR — ไม่ทำงานในฟังก์ชัน
  • ตั้ง trap ... EXIT ก่อนสร้าง tmpdir — trap อ้าง $tmpdir ที่ยังไม่มี ตั้ง trap ทันทีหลัง mktemp
  • cleanup ไม่เก็บ $? บรรทัดแรก — คำสั่งใน cleanup ทับ exit status เดิม
  • พยายาม trap SIGKILL (9) — ทำไม่ได้ อย่าพึ่งพา
  • trap '' INT แล้วลืมคืน — Ctrl+C ใช้ไม่ได้ตลอดสคริปต์
  • EXIT trap ที่ exit เอง เปลี่ยน exit code — ระวัง trap 'cleanup' EXIT ที่ cleanup มี exit 0 กลบ error

สรุป

  • signal: INT (Ctrl+C), TERM (kill ปกติ), HUP (terminal ปิด), KILL (9 — trap ไม่ได้)
  • trap 'คำสั่ง' SIGNAL — ครอบด้วย single quote (ตีความตอน trap ทำงาน)
  • trap 'rm -rf "$tmp"' EXIT = ท่ามาตรฐาน ลบไฟล์ชั่วคราวตอนจบเสมอ — ตั้งทันทีหลัง mktemp
  • cleanup function: บรรทัดแรก local rc=$? เก็บ exit status ก่อนถูกทับ
  • set -E + trap '...' ERR — รายงาน $LINENO และ $BASH_COMMAND ที่พัง
  • trap - SIG คืนปริยาย, trap '' SIG เพิกเฉย (กันงาน critical ถูกขัด — อย่าลืมคืน)
  • graceful shutdown: trap 'running=false' TERM + while $running
  • timeout N cmd จำกัดเวลา (exit 124 = ถูก timeout ฆ่า)

บทถัดไปว่าด้วยการจัดการข้อผิดพลาดเต็มรูปแบบ — set -euo pipefail ทุกข้อยกเว้น และ die pattern