orhan.cn - 数据库
Zola
2025-09-16T00:00:00+00:00
https://orhan.cn/tags/shu-ju-ku/atom.xml
Postgres数据库的peer认证方式下API进行数据库操作
2025-09-16T00:00:00+00:00
2025-09-16T00:00:00+00:00
menzil
https://orhan.cn/posts/postgres-feer-auth-and-api/
<p>AI建议</p>
<pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>对于Web API系统，建议使用密码认证（md5或scram-sha-256）而不是peer认证，因为：
</span><span>
</span><span>配置更简单 - 无需复杂的用户名映射
</span><span>更灵活 - 支持远程连接和容器化部署
</span><span>更适合API场景 - Web API通常不需要peer认证提供的操作系统级别的身份验证
</span><span>peer认证更适合于系统管理员直接访问数据库的场景，而不是Web API应用程序。
</span></code></pre>
<p>但是我就想试一下peer认证方式的可行性。结果跟AI聊了半天才解决了这个问题，下面记录一下步骤：</p>
<ol>
<li>首先保证用table plus等数据库管理软件能够登录正常（这个是之前就配置好的，所有没有记录）</li>
<li>修个数据库的 pg_hba.conf 文件，在 pg_hba.conf 文件中，对于 local 连接类型（Unix domain socket），您需要在认证方法后面添加 map=your_map_name 选项。 client-auth.sgml:150</li>
</ol>
<p>正确的配置格式</p>
<pre data-lang="sh" style="background-color:#2b303b;color:#c0c5ce;" class="language-sh "><code class="language-sh" data-lang="sh"><span style="color:#b48ead;">local </span><span style="color:#bf616a;">database user peer map</span><span>=</span><span style="color:#a3be8c;">your_map_name
</span><span style="color:#bf616a;">这里：
</span><span>
</span><span style="color:#b48ead;">local </span><span style="color:#bf616a;">表示使用 Unix domain socket 连接 client-auth.sgml:172-174
</span><span style="color:#bf616a;">all</span><span> 表示所有数据库
</span><span style="color:#bf616a;">all</span><span> 表示所有用户
</span><span style="color:#bf616a;">peer</span><span> 是认证方法
</span><span style="color:#bf616a;">map</span><span>=</span><span style="color:#a3be8c;">mypeermap </span><span style="color:#bf616a;">指定使用名为</span><span> mypeermap 的用户名映射
</span></code></pre>
<ol start="3">
<li>用户名映射配置
相应地，您需要在 pg_ident.conf 文件中定义这个映射：</li>
</ol>
<pre data-lang="sh" style="background-color:#2b303b;color:#c0c5ce;" class="language-sh "><code class="language-sh" data-lang="sh"><span style="color:#65737e;"># MAPNAME SYSTEM-USERNAME DATABASE-USERNAME
</span><span style="color:#bf616a;">mypeermap</span><span> your_system_user your_db_user
</span></code></pre>
<p>当我运行migrate时报错
您遇到的是PostgreSQL schema权限问题。当使用peer认证时，您的API用户缺少对public schema的必要权限来执行migration操作
这个错误表明您的数据库用户（通过peer认证映射的用户）没有在public schema中创建对象的权限。
在PostgreSQL 15及更高版本中，默认情况下已经撤销了public schema的CREATE权限，这是为了提高安全性。</p>
<pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>调试步骤
</span><span>确认当前连接用户：
</span><span>SELECT current_user, session_user, system_user;
</span><span>检查该用户的schema权限：
</span><span>SELECT has_schema_privilege(current_user, 'public', 'CREATE');
</span><span>SELECT has_schema_privilege(current_user, 'public', 'USAGE');
</span><span>如果权限检查返回false，为实际用户授权：
</span><span>GRANT CREATE ON SCHEMA public TO <actual_user>;
</span><span>GRANT USAGE ON SCHEMA public TO <actual_user>;
</span></code></pre>