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

0P000 invalid role specification 는?

PostgreSQL 에러 코드 0P000은 invalid role specification, 즉 “유효하지 않은 롤 지정” 오류입니다. 이 에러는 SET ROLE, SET SESSION AUTHORIZATION, GRANT, REVOKE 등의 명령어에서 존재하지 않거나 접근할 수 없는 롤(Role)을 지정했을 때 발생합니다. 데이터베이스 내에 해당 롤이 아예 없거나, 현재 사용자가 해당 롤로 전환할 권한이 없는 경우에도 동일한 에러가 트리거됩니다.

---

주요 발생 원인

1. 존재하지 않는 롤 이름 지정

가장 흔한 원인으로, 오타나 대소문자 혼동으로 인해 실제로 데이터베이스에 존재하지 않는 롤 이름을 명령어에 사용하는 경우입니다. PostgreSQL의 롤 이름은 기본적으로 대소문자를 구분하지 않지만, 따옴표로 묶인 식별자를 사용할 경우 대소문자가 구분되어 혼란을 야기할 수 있습니다. 예를 들어 "Admin"과 admin은 PostgreSQL 내부에서 서로 다른 롤로 취급될 수 있습니다.

2. SET ROLE 명령에서 현재 사용자가 해당 롤의 멤버가 아닌 경우

SET ROLE 명령어를 사용할 때, 현재 세션의 사용자가 전환하려는 롤의 멤버(member)가 아니거나 SUPERUSER 권한이 없다면 이 에러가 발생합니다. PostgreSQL에서 롤 전환은 멤버십 기반으로 동작하기 때문에, GRANT role TO user 구문으로 명시적으로 멤버십이 부여되어 있어야 합니다. 이 부분은 개발 환경과 운영 환경 간의 권한 구성 차이로 인해 자주 발생하는 실수입니다.

3. 애플리케이션 또는 마이그레이션 스크립트에서 롤 삭제 후 참조

데이터베이스 롤을 DROP ROLE 명령으로 삭제했음에도 불구하고, 애플리케이션 설정 파일이나 마이그레이션 스크립트, 접속 풀(Connection Pool) 설정에 해당 롤 이름이 남아 있어 참조하려 할 때 발생합니다. 특히 PgBouncer나 pgPool-II 같은 커넥션 풀러에서 특정 롤로 세션을 초기화하는 설정이 남아 있을 때 이 에러가 대량으로 발생할 수 있습니다.

---

해결 방법

원인 1: 존재하지 않는 롤 확인 및 생성

먼저 현재 데이터베이스에 어떤 롤이 존재하는지 확인합니다.

-- 전체 롤 목록 확인
SELECT rolname, rolsuper, rolinherit, rolcreaterole, rolcreatedb, rolcanlogin
FROM pg_roles
ORDER BY rolname;

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

롤이 존재하지 않는다면 아래와 같이 생성합니다.

-- 기본 롤 생성 (로그인 불가)
CREATE ROLE app_readonly;

-- 로그인 가능한 롤 생성
CREATE ROLE app_user WITH LOGIN PASSWORD 'secure_password';

-- 특정 권한을 가진 롤 생성
CREATE ROLE report_user WITH LOGIN PASSWORD 'report_pass' NOSUPERUSER NOCREATEDB NOCREATEROLE;

원인 2: SET ROLE 실패 시 멤버십 부여

현재 사용자의 롤 멤버십을 확인하고, 필요한 경우 멤버십을 부여합니다.

-- 현재 사용자의 멤버십 확인
SELECT r.rolname AS role_name,
       m.rolname AS member_name,
       g.admin_option
FROM pg_auth_members am
JOIN pg_roles r ON r.oid = am.roleid
JOIN pg_roles m ON m.oid = am.member
JOIN pg_roles g ON g.oid = am.grantor
WHERE m.rolname = current_user;

-- 롤 멤버십 부여
GRANT app_readonly TO current_app_user;

-- 멤버십 부여 후 롤 전환 테스트
SET ROLE app_readonly;

-- 현재 롤 확인
SELECT current_role, current_user, session_user;

-- 원래 롤로 복구
RESET ROLE;

원인 3: 삭제된 롤을 참조하는 객체 정리

롤 삭제 전에 반드시 해당 롤을 참조하는 객체들을 점검하고 정리해야 합니다.

-- 특정 롤이 소유한 객체 확인
SELECT n.nspname AS schema,
       c.relname AS object_name,
       c.relkind AS object_type,
       r.rolname AS owner
FROM pg_class c
JOIN pg_roles r ON r.oid = c.relowner
JOIN pg_namespace n ON n.oid = c.relnamespace
WHERE r.rolname = 'old_role_name';

-- 소유권 이전 후 롤 삭제
REASSIGN OWNED BY old_role TO new_owner_role;
DROP OWNED BY old_role;
DROP ROLE old_role;

-- 롤에 부여된 권한 확인
SELECT grantee, table_schema, table_name, privilege_type
FROM information_schema.role_table_grants
WHERE grantee = 'old_role_name';

애플리케이션 레벨에서 SET ROLE을 사용하는 경우, 에러 핸들링을 추가합니다.

-- 트랜잭션 내 안전한 롤 전환 예제
DO $$
BEGIN
    -- 롤 존재 여부 사전 확인
    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'target_role') THEN
        SET LOCAL ROLE target_role;
        -- 실제 작업 수행
        RAISE NOTICE 'Role switched successfully';
    ELSE
        RAISE EXCEPTION 'Role target_role does not exist';
    END IF;
END;
$$;

---

예방 방법

1. 롤 관리를 위한 IaC(Infrastructure as Code) 도입

Terraform, Ansible, 또는 Flyway/Liquibase 같은 마이그레이션 도구를 활용하여 PostgreSQL 롤 생성과 삭제를 코드로 관리하세요. 이렇게 하면 개발, 스테이징, 운영 환경 간의 롤 구성 불일치를 방지하고, 롤 변경 이력을 Git을 통해 추적할 수 있습니다. 롤 삭제 시에도 스크립트 내에서 의존성 검사를 먼저 수행하도록 자동화하면 0P000 에러의 발생 빈도를 크게 줄일 수 있습니다.

-- 롤 존재 여부를 확인하며 안전하게 생성하는 패턴
DO $$
BEGIN
    IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'app_service_role') THEN
        CREATE ROLE app_service_role WITH LOGIN PASSWORD 'strong_password_here';
        GRANT CONNECT ON DATABASE mydb TO app_service_role;
        GRANT USAGE ON SCHEMA public TO app_service_role;
        GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO app_service_role;
    END IF;
END;
$$;

2. 주기적인 롤 감사(Audit) 및 모니터링 자동화

운영 환경에서는 정기적으로 pg_roles, pg_auth_members 시스템 카탈로그를 쿼리하여 불필요한 롤, 과도한 권한을 가진 롤, 참조는 되지만 실제로 존재하지 않는 롤을 탐지하는 감사 쿼리를 스케줄링하세요. 또한 log_connections = on, log_disconnections = on 설정을 활성화하여 롤 관련 인증 오류를 PostgreSQL 로그에서 신속하게 탐지할 수 있도록 구성하는 것이 좋습니다.

---

관련 에러

• 42501 insufficient_privilege: 롤은 존재하지만 해당 작업을 수행할 권한이 없을 때 발생하는 에러로, 0P000과 함께 권한 관련 문제 해결 시 함께 검토해야 합니다.
• 28000 invalid_authorization_specification: 로그인 자체가 실패할 때 발생하며, 롤은 존재하지만 NOLOGIN 속성이 있거나 인증 방식 문제일 때 나타납니다.
• 42704 undefined_object: DROP ROLE이나 ALTER ROLE 명령에서 존재하지 않는 롤을 대상으로 할 때 발생하며, 0P000과 유사한 상황에서 나타날 수 있습니다.

---

본 포스트는 AI가 생성한 기술 가이드입니다. 운영 환경 적용 전 충분한 검토를 권장합니다.