PostgreSQL 0B000 오류 원인과 해결 방법 완벽 가이드

0B000
2026년 06월 01일 | DBMS Error 가이드

이 글에서 다루는 내용

0B000 에러의 원인 분석, 해결 SQL, 예방 방법을 실무 관점에서 정리합니다.

0B000 invalid transaction initiation 는?

PostgreSQL 에러 코드 0B000 (invalid_transaction_initiation)은 현재 트랜잭션 컨텍스트에서 허용되지 않는 방식으로 트랜잭션을 시작하려 할 때 발생합니다. 주로 이미 트랜잭션 블록 내에 있는 상태에서 중첩된 BEGIN 명령을 실행하거나, 특정 함수나 트리거 컨텍스트 내에서 트랜잭션을 부적절하게 초기화하려 할 때 나타납니다. 이 에러는 PostgreSQL의 트랜잭션 관리 규칙을 위반했음을 의미하며, 데이터 무결성 보호를 위한 중요한 안전 장치입니다.

주요 발생 원인

1. 트랜잭션 블록 내에서 중첩 BEGIN 실행

가장 흔한 원인으로, 이미 BEGIN으로 시작된 트랜잭션 블록 내에서 다시 BEGIN을 호출하는 경우입니다. PostgreSQL은 표준 SQL 트랜잭션 모델에서 진정한 중첩 트랜잭션(nested transaction)을 지원하지 않으며, 이러한 시도가 발생하면 0B000 에러 또는 경고를 발생시킵니다. 실제로 PostgreSQL은 이 경우 WARNING 메시지를 출력하고 내부 BEGIN을 무시하지만, 일부 드라이버나 미들웨어는 이를 에러로 처리합니다.

2. PL/pgSQL 함수 또는 트리거 내에서 트랜잭션 제어 명령 사용

PL/pgSQL 함수 내부에서 명시적으로 BEGIN, COMMIT, ROLLBACK을 사용하려 할 때 이 에러가 발생할 수 있습니다. 일반 함수(function)는 호출자의 트랜잭션 컨텍스트 안에서 실행되므로 독립적인 트랜잭션 제어가 불가능합니다. PostgreSQL 11 이후에는 프로시저(PROCEDURE)에서 트랜잭션 제어가 가능하지만, 일반 함수에서는 여전히 제한됩니다.

3. 자동 커밋(Autocommit)이 비활성화된 상태에서의 잘못된 트랜잭션 관리

일부 클라이언트 라이브러리나 ORM은 기본적으로 autocommit을 비활성화하며, 이 상태에서 명시적 BEGIN을 중복 호출하면 문제가 발생합니다. 특히 Python의 psycopg2, Java의 JDBC, 또는 다양한 ORM 프레임워크에서 연결 풀링과 트랜잭션 관리가 혼재될 때 이런 상황이 자주 발생합니다. 개발자가 수동으로 BEGIN을 실행하면서 동시에 ORM이 자동으로 트랜잭션을 시작하는 충돌 상황이 대표적입니다.

해결 방법

원인 1 해결: 중첩 BEGIN 대신 SAVEPOINT 사용

중첩 트랜잭션이 필요한 경우 SAVEPOINT를 사용하여 부분 롤백이 가능한 구조를 만드세요.

-- 잘못된 방법 (0B000 에러 유발 가능)
BEGIN;
  INSERT INTO orders (customer_id, amount) VALUES (1, 5000);
  BEGIN;  -- WARNING 또는 에러 발생!
    INSERT INTO order_items (order_id, product_id) VALUES (1, 101);
  COMMIT;
COMMIT;

-- 올바른 방법: SAVEPOINT 활용
BEGIN;
  INSERT INTO orders (customer_id, amount) VALUES (1, 5000);
  
  SAVEPOINT before_items;  -- 중간 저장점 설정
  
  INSERT INTO order_items (order_id, product_id) VALUES (1, 101);
  
  -- 문제 발생 시 SAVEPOINT로 롤백
  -- ROLLBACK TO SAVEPOINT before_items;
  
  -- 정상 진행 시 SAVEPOINT 해제
  RELEASE SAVEPOINT before_items;
  
COMMIT;

원인 2 해결: 함수 대신 프로시저(PROCEDURE) 사용

PostgreSQL 11 이상에서 트랜잭션 제어가 필요하다면 함수 대신 프로시저를 사용하세요.

-- 잘못된 방법: 일반 함수에서 트랜잭션 제어 시도
CREATE OR REPLACE FUNCTION bad_transaction_func()
RETURNS VOID AS $$
BEGIN
    INSERT INTO audit_log (event) VALUES ('start');
    COMMIT;  -- 에러 발생! 함수 내에서 COMMIT 불가
    INSERT INTO audit_log (event) VALUES ('end');
END;
$$ LANGUAGE plpgsql;

-- 올바른 방법: PROCEDURE 사용 (PostgreSQL 11+)
CREATE OR REPLACE PROCEDURE correct_transaction_proc()
LANGUAGE plpgsql
AS $$
BEGIN
    INSERT INTO audit_log (event, created_at) VALUES ('process_start', NOW());
    COMMIT;  -- 프로시저에서는 COMMIT 가능
    
    INSERT INTO audit_log (event, created_at) VALUES ('process_end', NOW());
    COMMIT;
END;
$$;

-- 프로시저 호출 (CALL 사용)
CALL correct_transaction_proc();

원인 3 해결: 클라이언트 측 트랜잭션 관리 정리

-- 현재 트랜잭션 상태 확인
SELECT pg_current_xact_id_if_assigned() IS NOT NULL AS in_transaction;

-- 트랜잭션 상태가 불분명할 때 안전하게 초기화
-- 기존 트랜잭션이 있으면 종료 후 새로 시작
DO $$
BEGIN
    -- 현재 트랜잭션 상태를 확인하는 방법
    RAISE NOTICE 'Transaction ID: %', txid_current();
END;
$$;

-- Python psycopg2 예시 (애플리케이션 레벨 해결책)
-- connection.autocommit = True 설정 후 명시적 트랜잭션 관리
-- 또는 connection.reset() 으로 상태 초기화 후 재시작

-- 트랜잭션 블록 상태 확인 쿼리
SELECT 
    pid,
    state,
    query,
    xact_start,
    now() - xact_start AS transaction_duration
FROM pg_stat_activity
WHERE xact_start IS NOT NULL
  AND pid = pg_backend_pid();

예방 방법

1. 트랜잭션 경계를 명확하게 정의하고 문서화하라

애플리케이션 코드에서 트랜잭션의 시작과 끝을 명확히 구분하고, 중첩 호출이 발생하지 않도록 설계하세요. 특히 서비스 레이어나 리포지토리 패턴을 사용하는 경우, 트랜잭션 전파 방식(propagation)을 명시적으로 정의하고, 이미 트랜잭션이 시작된 상태에서 새로운 트랜잭션이 필요할 때는 SAVEPOINT를 사용하는 것을 팀 내 코딩 표준으로 정립하세요.

-- 트랜잭션 상태 모니터링 뷰 생성 (운영 환경 모니터링용)
CREATE OR REPLACE VIEW v_active_transactions AS
SELECT
    pid,
    usename,
    application_name,
    state,
    xact_start,
    now() - xact_start AS duration,
    query
FROM pg_stat_activity
WHERE xact_start IS NOT NULL
ORDER BY xact_start;

2. 트랜잭션 관련 로깅과 예외 처리를 강화하라

log_min_messages와 client_min_messages를 WARNING 이상으로 설정하여 중첩 트랜잭션 시도와 같은 경고 메시지를 반드시 기록하세요. PL/pgSQL 코드에서는 EXCEPTION 블록을 활용하여 트랜잭션 오류를 적절히 처리하고, 에러 발생 시 명확한 컨텍스트 정보를 로그에 남기도록 구성해야 합니다.

-- postgresql.conf 설정 권장값
-- log_min_messages = warning
-- client_min_messages = notice

-- PL/pgSQL 에러 처리 모범 사례
CREATE OR REPLACE PROCEDURE safe_batch_process(batch_id INT)
LANGUAGE plpgsql
AS $$
BEGIN
    INSERT INTO batch_log (batch_id, status, started_at)
    VALUES (batch_id, 'RUNNING', NOW());
    COMMIT;
    
    -- 실제 작업 수행
    UPDATE batch_jobs SET processed = TRUE WHERE id = batch_id;
    
    UPDATE batch_log SET status = 'COMPLETED', finished_at = NOW()
    WHERE batch_id = batch_id;
    COMMIT;

EXCEPTION WHEN OTHERS THEN
    UPDATE batch_log SET status = 'FAILED', error_msg = SQLERRM
    WHERE batch_id = batch_id;
    COMMIT;
    RAISE;
END;
$$;