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

0P000
2026년 06월 02일 | DBMS Error 가이드

이 글에서 다루는 내용

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

0P000 invalid role specification 는?

PostgreSQL에서 0P000 invalid role specification 에러는 데이터베이스 시스템이 지정된 롤(Role) 이름을 인식하지 못하거나, 해당 롤이 존재하지 않을 때 발생합니다. 주로 GRANT, REVOKE, SET ROLE, ALTER TABLE OWNER TO 등의 권한 관련 명령어를 실행할 때 잘못된 롤 이름을 지정하면 이 에러가 트리거됩니다. 대소문자 불일치, 오타, 혹은 롤이 사전에 생성되지 않은 경우가 가장 흔한 원인이며, 운영 환경에서 마이그레이션이나 스크립트 자동화 과정 중에 특히 자주 나타납니다.

주요 발생 원인

1. 존재하지 않는 롤에 권한 부여 시도

가장 빈번하게 발생하는 원인으로, 실제로 데이터베이스에 생성되지 않은 롤에 대해 GRANT 또는 REVOKE 명령을 실행할 때 나타납니다. 예를 들어, 애플리케이션 배포 스크립트에서 롤 생성 단계를 빠뜨리거나, 다른 환경에서는 존재하지만 현재 환경에는 없는 롤을 참조하는 경우가 대표적입니다. 이 경우 PostgreSQL은 시스템 카탈로그(pg_roles)에서 해당 롤을 찾지 못하고 즉시 에러를 반환합니다.

2. 롤 이름의 대소문자 또는 따옴표 처리 오류

PostgreSQL은 따옴표가 없는 식별자를 소문자로 변환합니다. 롤을 생성할 때 큰따옴표(")를 사용해 대소문자를 보존했다면, 이후 명령에서도 동일하게 따옴표를 사용해야 합니다. 예를 들어 CREATE ROLE "MyAppUser"로 생성한 롤을 GRANT ... TO MyAppUser로 참조하면 PostgreSQL은 myappuser라는 롤을 찾게 되고, 이는 존재하지 않으므로 에러가 발생합니다. 이 문제는 특히 다른 DBMS에서 마이그레이션할 때 자주 발생합니다.

3. SET ROLE 또는 SET SESSION AUTHORIZATION 명령에서의 잘못된 롤 지정

SET ROLE 명령은 현재 세션의 실행 권한을 다른 롤로 전환할 때 사용됩니다. 이 명령에서 지정한 롤이 존재하지 않거나, 현재 사용자가 해당 롤의 멤버가 아닌 경우에도 0P000 에러가 발생할 수 있습니다. 또한 연결 풀링 도구(예: PgBouncer)를 사용하는 환경에서 세션 초기화 쿼리에 잘못된 롤이 포함된 경우 반복적으로 이 에러가 나타날 수 있습니다.

해결 방법

원인 1 해결: 롤 존재 여부 확인 후 생성

먼저 pg_roles 카탈로그를 조회해 롤이 실제로 존재하는지 확인합니다.

-- 현재 데이터베이스에 존재하는 모든 롤 확인
SELECT rolname, rolsuper, rolcreatedb, rolcreaterole, rolcanlogin
FROM pg_roles
ORDER BY rolname;

-- 특정 롤 존재 여부 확인
SELECT EXISTS (
    SELECT 1 FROM pg_roles WHERE rolname = 'app_user'
) AS role_exists;

롤이 없다면 아래와 같이 생성한 후 권한을 부여합니다.

-- 롤 생성 (로그인 가능 여부 포함)
CREATE ROLE app_user WITH LOGIN PASSWORD 'securepassword123';

-- 특정 데이터베이스에 접속 권한 부여
GRANT CONNECT ON DATABASE myapp_db TO app_user;

-- 특정 스키마의 사용 권한 부여
GRANT USAGE ON SCHEMA public TO app_user;

-- 테이블 읽기 권한 부여
GRANT SELECT ON ALL TABLES IN SCHEMA public TO app_user;

-- 이후 생성될 테이블에도 자동으로 권한 부여 (기본 권한 설정)
ALTER DEFAULT PRIVILEGES IN SCHEMA public
    GRANT SELECT ON TABLES TO app_user;

원인 2 해결: 롤 이름 따옴표 처리 통일

대소문자를 구분하는 롤 이름을 사용해야 한다면 생성부터 참조까지 일관되게 큰따옴표를 사용해야 합니다.

-- 대소문자 보존 롤 생성 (큰따옴표 필수)
CREATE ROLE "MyAppUser" WITH LOGIN PASSWORD 'password123';

-- 올바른 참조 방법 (큰따옴표 사용)
GRANT SELECT ON TABLE orders TO "MyAppUser";

-- 잘못된 참조 방법 (에러 발생!)
-- GRANT SELECT ON TABLE orders TO MyAppUser;  -- 내부적으로 myappuser로 변환됨

-- 현재 존재하는 롤의 정확한 이름 확인
SELECT quote_ident(rolname) AS quoted_rolname, rolname AS original_rolname
FROM pg_roles
WHERE rolname ILIKE '%myapp%';

원인 3 해결: SET ROLE 전 멤버십 확인

-- 현재 사용자가 속한 롤(그룹) 목록 확인
SELECT r.rolname AS role_name,
       m.member::regrole AS member_role
FROM pg_auth_members m
JOIN pg_roles r ON r.oid = m.roleid
WHERE m.member = (SELECT oid FROM pg_roles WHERE rolname = current_user);

-- 특정 롤로 전환하기 전에 권한 확인
DO $$
BEGIN
    IF EXISTS (
        SELECT 1
        FROM pg_auth_members am
        JOIN pg_roles r ON r.oid = am.roleid
        WHERE r.rolname = 'target_role'
          AND am.member = (SELECT oid FROM pg_roles WHERE rolname = current_user)
    ) THEN
        SET ROLE target_role;
        RAISE NOTICE 'Role switched successfully.';
    ELSE
        RAISE NOTICE 'Current user is not a member of target_role.';
    END IF;
END;
$$;

-- 세션 종료 후 원래 롤로 복귀
RESET ROLE;

예방 방법

1. 배포 스크립트에 롤 존재 여부 검증 로직 추가

운영 환경에서 마이그레이션 스크립트나 배포 자동화 파이프라인을 구성할 때, 권한 부여 명령 이전에 반드시 롤 존재 여부를 검증하는 로직을 포함하세요. CREATE ROLE IF NOT EXISTS 구문(PostgreSQL 9.5 이상)을 활용하면 롤이 이미 존재할 때 에러 없이 넘어갈 수 있습니다.

-- PostgreSQL 9.5 이상에서 안전한 롤 생성
CREATE ROLE IF NOT EXISTS app_readonly WITH LOGIN PASSWORD 'readonly_pass';
CREATE ROLE IF NOT EXISTS app_readwrite WITH LOGIN PASSWORD 'readwrite_pass';

-- 롤 생성 후 권한 부여를 하나의 트랜잭션으로 묶어 원자성 보장
BEGIN;
    GRANT CONNECT ON DATABASE myapp_db TO app_readonly;
    GRANT USAGE ON SCHEMA public TO app_readonly;
    GRANT SELECT ON ALL TABLES IN SCHEMA public TO app_readonly;
COMMIT;

2. 롤 명명 규칙(Naming Convention) 표준화

대소문자 혼용이나 특수문자 사용으로 인한 따옴표 문제를 원천적으로 방지하려면, 팀 내에서 롤 명명 규칙을 소문자와 언더스코어(_)만 사용하는 방식으로 표준화하세요. 또한 롤 이름에 환경 접두사(예: prod_, dev_, stg_)를 붙이는 관행을 도입하면 환경 간 혼동을 방지하고 관리 효율을 높일 수 있습니다.

-- 권장 명명 규칙 예시
CREATE ROLE prod_app_readonly  WITH LOGIN PASSWORD '...';
CREATE ROLE prod_app_readwrite WITH LOGIN PASSWORD '...';
CREATE ROLE prod_app_admin     WITH LOGIN PASSWORD '...';

-- 롤 계층 구조 설정 (그룹 롤 활용)
CREATE ROLE prod_readonly_group;
GRANT prod_readonly_group TO prod_app_readonly;