error() 함수
error()로 오류를 발생시키고 오류 수준과 메시지를 이해합니다.
error() 함수은(는) CoddyKit의 무료 Lua Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Lua Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
오류 발생시키기
error(message, level)은 Lua 오류를 발생시킵니다. 실행이 중지되고 오류는 pcall이나 xpcall이 포착하거나 프로그램이 종료될 때까지 호출 스택을 따라 전파됩니다. 메시지는 문자열, 테이블, 숫자 등 어떤 값이든 될 수 있습니다.
local function divide(a, b)
if b == 0 then
error("division by zero")
end
return a / b
end
print(divide(10, 2)) -- 5.0
-- divide(10, 0) -- ERROR: division by zero오류 수준
error()의 두 번째 인수는 오류가 보고되는 위치를 제어합니다. 수준 1(기본값)은 error() 호출 자체를 가리킵니다. 수준 2는 호출자를 가리킵니다. 수준 0은 위치 정보를 추가하지 않습니다. 라이브러리 함수에서는 사용자 코드를 원인으로 표시하도록 수준 2를 사용하십시오.
local function assertPositive(n, name)
if n <= 0 then
error((name or "value") .. " must be positive, got " .. n, 2)
-- level 2: blame the caller, not this function
end
return n
end
local function compute(x)
assertPositive(x, "x") -- error points here if x <= 0
return math.sqrt(x)
end
compute(-5) -- error: "x must be positive, got -5" at compute() call테이블 객체를 사용한 오류
테이블을 오류 값으로 전달하면 호출자가 오류 코드, 메시지, 컨텍스트와 같은 구조화된 오류 정보를 확인할 수 있습니다. 단순한 문자열보다 더 많은 정보를 제공하며 프로그래밍 방식의 오류 처리를 가능하게 합니다.
local function openDB(host, port)
if port < 1 or port > 65535 then
error({code="INVALID_PORT", port=port,
msg="port out of range: " .. port})
end
-- ... connect
return {host=host, port=port}
end
local ok, err = pcall(openDB, "localhost", -1)
if not ok and type(err) == "table" then
print("Code:", err.code) -- INVALID_PORT
print("Port:", err.port) -- -1
print("Msg:", err.msg)
endassert()를 사용한 간편한 표현
assert(v, msg)는 if not v then error(msg, 2) end; return v, ...와 같습니다. 사전 조건을 확인할 때 사용하는 관용적인 방법입니다. v가 참으로 평가되면 assert는 모든 인수를 반환하므로 연결 호출에 유용합니다.
local function sqrt(n)
assert(type(n) == "number", "expected number, got " .. type(n))
assert(n >= 0, "sqrt of negative: " .. n)
return math.sqrt(n)
end
print(sqrt(16)) -- 4.0
print(sqrt(2)) -- 1.4142...
-- sqrt("hi") -- ERROR: expected number, got stringerror()와 return nil,err 비교
실패를 알리는 규칙에는 error()(예외 방식)와 return nil, msg(함수형 방식)의 두 가지가 있습니다. 정말 예상하지 못한 상황(프로그래밍 오류, 계약 위반)에는 error()를 사용하십시오. 예상 가능한 실패(파일을 찾을 수 없음, 네트워크 시간 초과)에는 nil, msg를 사용하십시오.
-- Exception style (programming error)
local function mustExist(t, key)
local v = t[key]
if v == nil then error("required key missing: " .. key, 2) end
return v
end
-- Functional style (expected failure)
local function findUser(id)
-- ... database query
return nil, "user not found" -- expected: user may not exist
end메타메서드에서의 오류
메타메서드 내부에서도 오류를 발생시킬 수 있습니다. 메타메서드에서 오류가 발생하면 산술식과 같이 해당 작업을 발생시킨 코드로 전파됩니다. 메타메서드에서는 항상 잘못된 입력을 방어적으로 처리하십시오.
local SafeDiv = {}
SafeDiv.__index = SafeDiv
SafeDiv.__div = function(a, b)
if b.value == 0 then
error("SafeDiv: division by zero", 2)
end
return SafeDiv.new(a.value / b.value)
end
function SafeDiv.new(v)
return setmetatable({value=v}, SafeDiv)
end
local a = SafeDiv.new(10)
local b = SafeDiv.new(0)
local ok, err = pcall(function() return a / b end)
print(ok, err)사용자 지정 오류 유형
유형이 지정된 오류 객체를 생성하는 도우미를 만드십시오. 호출자가 서로 다른 종류의 오류를 구분하고 각각 적절히 처리할 수 있도록 유형 태그를 포함하십시오.
local function newError(kind, msg, extra)
return setmetatable(
{kind=kind, message=msg, extra=extra},
{__tostring = function(e)
return "[" .. e.kind .. "] " .. e.message
end}
)
end
local E = {
notFound = function(name) return newError("NOT_FOUND","not found: "..name) end,
badInput = function(msg) return newError("BAD_INPUT", msg) end,
}
local ok, err = pcall(error, E.notFound("config.json"))
if not ok then print(err.kind, err.message) end오류 전파
함수가 오류를 발생시키는 다른 함수를 호출하면 오류는 호출 스택을 따라 자동으로 전파됩니다. 오류를 다시 발생시킬 필요는 없습니다. 오류를 잡지 않으면 됩니다. 의미 있게 처리하거나 보고할 수 있는 수준에서만 오류를 잡으십시오.
local function step3() error("step3 failed") end
local function step2() step3() end
local function step1() step2() end
local ok, err = pcall(step1)
if not ok then
-- err includes the source location
print("Caught at top level:", err)
end
-- Error: input:1: step3 faileddebug.traceback을 사용한 호출 스택 추적
일반적인 error()는 한 줄의 문맥만 제공합니다. 전체 호출 스택 추적이 필요하다면 debug.traceback(msg)를 오류 값으로 사용하십시오. 이는 일반적으로 xpcall 처리기에서 수행합니다.
local function buggy()
local t = nil
return t.field -- nil indexing: error
end
local ok, err = xpcall(buggy, function(e)
return debug.traceback(e, 2) -- full stack trace
end)
if not ok then
print(err) -- full traceback
end오류 다시 발생시키기
문맥을 추가하기 위해 오류를 잡은 다음 다시 발생시켜야 할 때가 있습니다. 이미 형식이 지정된 메시지에 위치 접두사가 하나 더 추가되는 것을 방지하려면 문자열 오류를 다시 발생시킬 때 error(err, 0)(수준 0)을 사용하십시오.
local function loadAndParse(path)
local ok, err = pcall(function()
local f = io.open(path, "r")
if not f then error("cannot open: " .. path) end
local content = f:read("a")
f:close()
return content
end)
if not ok then
error("loadAndParse failed: " .. err, 0) -- re-raise with context
end
end
local ok2, msg = pcall(loadAndParse, "missing.txt")
print(ok2, msg)빠른 확인
error("msg", 2)에서 수준 2는 무엇을 의미합니까?
복습: error()
요약:
error(msg, level)— 오류를 발생시킵니다. 수준 2는 호출자에게 책임을 돌립니다.- 유형과 문맥이 있는 구조화된 오류에는 테이블을 사용합니다.
assert(v, msg)— 관용적인 사전 조건 확인입니다.- 버그에는
error()를 사용하고, 예상되는 실패에는 nil+err을 반환합니다. - 메시지 형식을 유지하려면
error(err, 0)으로 다시 발생시킵니다.
자주 묻는 질문
“error() 함수” 강의는 무료인가요?
네 — “error() 함수” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Lua Academy 강의 전체를 잠금 해제할 수 있습니다. Lua Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“error() 함수”에서 뭘 배우나요?
error()로 오류를 발생시키고 오류 수준과 메시지를 이해합니다. 브라우저에서 직접 실행하는 실습 코드로 Lua Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Lua Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Lua Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“error() 함수” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Lua Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Lua Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.