Azure上配置Postgres的Corda节点启动失败：relation 'node_checkpoints'不存在

从你提供的报错日志来看，核心问题非常明确：

ERROR: relation "node_checkpoints" does not exist Position: 13

这个表是Corda节点存储流checkpoint数据的核心依赖，节点重启时会通过它恢复未完成的业务流，找不到该表直接导致启动失败。结合你提到的节点意外宕机背景，下面是一步步的排查和修复思路：

第一步：确认PostgreSQL数据库的状态 #

• 登录你的Azure PostgreSQL实例（可以用psql命令行工具，或者Azure Portal自带的数据库查询编辑器）
• 切换到Corda节点对应的数据库，执行\dt命令查看所有表列表：

  \dt
  

  • 如果node_checkpoints不在列表里，说明表确实丢失或被误删
  • 如果表存在，执行简单查询验证表是否可用：

    SELECT COUNT(*) FROM node_checkpoints;
    

    若查询报错，说明表已损坏

第二步：定位宕机的根本原因 #

• 检查Azure VM的系统日志：
  • Linux系统查看/var/log/syslog或/var/log/messages，排查是否有内存耗尽、磁盘空间不足、系统崩溃的记录
  • Windows系统打开事件查看器，检查系统日志中的错误事件
• 查看PostgreSQL的服务器日志（在Azure Portal的Postgres实例面板中找到「服务器日志」选项），排查宕机时是否有表损坏、磁盘I/O错误、连接异常的信息——磁盘满是导致Postgres表损坏或丢失的常见诱因

第三步：根据表的状态选择修复方案 #

情况1：node_checkpoints表丢失 #

• 优先使用备份恢复：如果你有最近的数据库全量备份，这是最安全的方案。先在测试环境恢复备份验证完整性，确认没问题后再替换生产环境的数据库
• 无备份的应急方案（风险高）：
  1. 确认同版本正常Corda节点的node_checkpoints表结构（可从其他正常节点导出表结构）
  2. 在故障数据库中手动创建该表（注意匹配Corda版本的表结构，不同版本字段可能有差异）
  3. 启动节点观察运行状态——这种方式会丢失所有未完成的流，需业务侧确认可接受

情况2：node_checkpoints表存在但损坏 #

• 尝试用PostgreSQL自带工具修复：

  -- 重建表索引
  REINDEX TABLE node_checkpoints;
  -- 整理表并修复损坏的页
  VACUUM FULL node_checkpoints;
  

• 若修复无效，只能导出其他正常表的数据，重新创建数据库并导入数据后启动节点——同样会丢失未完成的流

第四步：验证节点配置与权限 #

• 检查Corda节点的node.conf文件，确认数据库连接参数（URL、用户名、密码）是否正确，有没有指向错误的Postgres实例
• 确认Postgres用户对该数据库拥有CREATE、SELECT、INSERT、UPDATE等必要权限，避免因权限不足导致节点无法访问表

后续预防建议 #

• 配置Azure PostgreSQL的自动备份，确保备份频率符合业务需求
• 监控VM的磁盘空间、内存使用率，设置告警避免资源耗尽导致宕机
• 配置Corda节点的自动重启机制，同时定期清理过期的checkpoint数据

内容的提问来源于stack exchange，提问作者Adrian