如何正确配置权限以启动PostgreSQL复制？解决Debezium教程中复制用户的walsender权限错误

你遇到的错误FATAL: must be superuser or replication role to start walsender，虽然已经给debezium用户授予了带REPLICATION属性的角色，但通常是以下几个环节没配置到位，按下面的步骤排查修复：

1. 确认debezium用户的复制权限是否生效 #

先以postgres超级用户登录数据库，执行以下SQL检查debezium用户的复制权限：

SELECT usename, userepl FROM pg_user WHERE usename = 'debezium';

如果返回的userepl是f，说明权限没有生效。这时候需要让debezium用户重新连接数据库（断开现有连接后重新登录），因为角色权限的变更需要新连接才能生效。

2. 配置pg_hba.conf允许复制连接 #

PostgreSQL不仅要求用户拥有复制权限，还需要在pg_hba.conf中明确允许该用户进行复制连接。找到你的PostgreSQL配置目录（通常是/var/lib/postgresql/<version>/main/或/etc/postgresql/<version>/main/），编辑pg_hba.conf文件，添加一行规则：

# 允许debezium用户从指定IP进行复制连接，替换<debezium-server-ip>为实际IP
host    replication     debezium     <debezium-server-ip>/32     scram-sha-256

如果Debezium和PostgreSQL在同一主机，也可以用127.0.0.1/32或者localhost。认证方式根据你的PostgreSQL配置调整（比如md5，但推荐用更安全的scram-sha-256）。

添加后，需要重启PostgreSQL服务或者执行SELECT pg_reload_conf();来加载新的配置：

# 重启服务（以Debian/Ubuntu为例）
sudo systemctl restart postgresql
# 或者重新加载配置
psql -U postgres -c "SELECT pg_reload_conf();"

3. 确认Debezium连接器的配置正确 #

确保你的Debezium PostgreSQL连接器配置中，使用的是debezium用户，并且指定了正确的复制插件。比如典型的配置片段：

{
  "name": "postgres-connector",
  "config": {
    "connector.class": "io.debezium.connector.postgresql.PostgresConnector",
    "database.hostname": "postgres-host",
    "database.port": "5432",
    "database.user": "debezium",
    "database.password": "my-secret-pw",
    "database.dbname": "your-db",
    "database.server.name": "postgres-server",
    "plugin.name": "pgoutput",
    "table.include.list": "public.person"
  }
}

重点确认database.user是debezium，plugin.name设置正确（pgoutput是PostgreSQL 10+推荐的内置插件）。

4. 额外说明：无关配置的影响 #

你创建的replication_group角色以及修改表owner的操作，和当前的复制权限问题无关——这个组主要用于表的访问权限控制，不影响复制槽的创建和walsender的启动，可以忽略这部分配置对当前错误的影响。

完成以上步骤后，重新启动Debezium连接器，应该就能正常创建复制槽并开始同步了。

内容的提问来源于stack exchange，提问作者An SO User