常见报错及解决方法
| 序号 | 报错信息 | 原因分析 | 解决方案 |
| 1 | could not connect to server: Connection refused | PostgresQL服务未启动或配置不正确，导致无法连接到服务器。 | 确保PostgreSQL服务正在运行，在Linux系统上，可以使用sudo service postgresql status命令检查服务状态；如果服务未运行，使用sudo service postgresql start命令启动服务，检查pg_hba.conf文件，确保允许你的IP地址连接数据库。 |
| 2 | relation "xxx" does not exist | 尝试查询或操作一个不存在的表或视图。 | 检查表名或视图名是否正确，确保在正确的模式下查找，使用\dn命令查看所有模式，使用\dt schema_name命令查看指定模式下的所有表。 |
| 3 | syntax error at or near "xxx" | SQL语句中存在语法错误。 | 仔细检查SQL语句，确保语法正确，可以使用在线SQL格式化工具来检查和格式化SQL语句，PostgreSQL的官方文档也是很好的参考资料。 |
| 4 | duplicate key value violates unique constraint | 试图插入一个与现有记录冲突的唯一键。 | 在插入新记录之前，检查是否存在具有相同唯一键的记录，可以使用SELECT语句查询数据库，确保新记录的唯一键不与现有记录冲突。 |
| 5 | out of memory | 数据库操作消耗了大量内存。 | 优化查询语句，减少返回的数据量，考虑增加服务器内存或调整PostgreSQL的内存配置参数（如work_mem、shared_buffers等），定期清理和维护数据库，删除不必要的数据和索引。 |
| 6 | deadlock detected | 多个事务互相等待对方释放资源，导致死锁。 | 检查引发死锁的事务，并尝试调整事务的执行顺序，避免循环等待，可以考虑使用SET TRANSACTION ISOLATION LEVEL SERIALIZABLE来设置事务的隔离级别为可串行化，让数据库自动处理死锁问题。 |
| 7 | Problem running postinstall | 权限不足或安装包问题导致无法初始化数据和注册服务。 | 添加权限：找到PostgreSQL的安装文件夹，右键点击选择“属性”，在“安全”选项卡中添加“Users”用户组并赋予完全控制权限，确保对安装目录和所有子文件夹都有完全控制权限，在带有版本号的文件夹上再次验证用户权限是否正确设置。 创建用户及设置权限：在Win11系统中创建一个名为“postgres”的用户，并将其添加到管理员群组和“Power Users”群组，同时设置“postgres”用户对PostgreSQL安装文件夹的完全控制权限。 初始化及注册服务：以管理员身份运行命令提示符（CMD），切换到PostgreSQL安装目录下的“bin”文件夹，执行初始化数据库命令 initdb.exe D data（这里的“data”是数据库的数据存储目录，可以根据实际情况进行修改），然后注册数据库服务，输入pg_ctl register N PostgreSQL D data（同样，“data”是数据存储目录）。启动及常用命令：在Windows服务面板中启动注册的PostgreSQL服务，打开“控制面板”>“管理工具”>“服务”，找到“PostgreSQL”服务，右键点击选择“启动”，常用命令包括启动服务 pg_ctl start D data、停止服务pg_ctl stop D data和删除服务pg_ctl unregister N PostgreSQL。 |
FAQs
Q1: 如何检查PostgreSQL服务是否正在运行？
A1: 在Linux系统上，可以使用以下命令检查PostgreSQL服务的状态：
（图片来源网络，侵权删除）
sudo service postgresql status
如果服务正在运行，你会看到类似于“postgresql is running”的消息，如果服务未运行，可以使用以下命令启动服务
sudo service postgresql start
Q2: 如果忘记PostgreSQL的超级用户密码怎么办？
A2: 如果忘记了PostgreSQL的超级用户密码，可以通过以下步骤重置密码：
1、以单用户模式启动PostgreSQL：
sudo service postgresql stop sudo u postgres bash
2、进入PostgreSQL命令行界面：
psql U postgres
3、使用ALTER USER命令重置密码：
（图片来源网络，侵权删除）
ALTER USER postgres PASSWORD 'new_password';
4、重新启动PostgreSQL服务：
sudo service postgresql restart
（图片来源网络，侵权删除）
