// PostgreSQL 오류 참조

PostgreSQL 25P03: 트랜잭션 중 유휴 세션 시간 초과

세션이 열린 트랜잭션 안에서 idle_in_transaction_session_timeout보다 오래 아무 것도 하지 않고 있었고, 그래서 서버가 세션을 닫았습니다.

SQLSTATE
25P03
이름
idle_in_transaction_session_timeout
카테고리
잘못된 트랜잭션 상태
오류 메시지
terminating connection due to idle-in-transaction timeout

의미

트랜잭션을 시작한 후 아무 작업도 하지 않는 세션은 idle in transaction. 잠금은 여전히 쥐고 있고, 오래된 행 버전이 VACUUM으로 정리되지 못 하게 만듭니다. idle_in_transaction_session_timeout 시간 제한이 지나면 서버가 이런 세션을 종료하도록 만듭니다. 이때 클라이언트가 받는 것이 바로 이 FATAL 오류를 받고 연결이 종료되며, 트랜잭션은 롤백됩니다.

일반적인 근본 원인은 트랜잭션을 열고 커밋하기 전에 네트워크 호출이나 사용자 입력과 같은 다른 작업을 기다리는 애플리케이션 코드입니다.

일반적인 원인

  • 느린 작업(HTTP 호출, 파일 처리)을 중간에 수행하는 코드 BEGIN 그리고 COMMIT.
  • autocommit을 끈 클라이언트나 GUI가 다음을 실행한 뒤에도 열려 있고 SELECT, 그래서 트랜잭션이 열린 상태로 유지됩니다.
  • 커밋도 롤백도 하지 않는 예외 경로로, 풀에 돌아간 연결이 트랜잭션 안에서 유휴 상태로 남습니다.

해결 방법

  1. 트랜잭션에서 유휴 상태인 세션과 유휴 상태로 있는 시간을 찾으세요.

    SELECT pid, usename, application_name, now() - state_change AS idle_for, query
    FROM pg_stat_activity
    WHERE state = 'idle in transaction'
    ORDER BY idle_for DESC;
  2. 트랜잭션을 열기 전에 또는 커밋 후에 느린 비데이터베이스 작업을 수행하고, 항상 트랜잭션을 커밋하거나 롤백합니다. finally 블록.

  3. 시간 제한은 안전망으로 유지하세요. 일부 작업이 정당한 이유로 더 긴 시간이 필요하다면 역할별 또는 데이터베이스별로 설정하세요.

    ALTER ROLE app SET idle_in_transaction_session_timeout = '5min';

관련 오류

그 밖의 잘못된 트랜잭션 상태 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.