瀚高数据库卸载后端口占用问题解决方案
1. 问题现象与背景分析
最近在卸载瀚高安全版V4.5.10数据库时，发现系统中仍然残留了db_ha的agent进程，导致6666端口持续被占用。这个问题看似简单，实则涉及到数据库服务的完整生命周期管理机制。
瀚高数据库作为国产数据库的重要代表，其高可用组件db_ha通过agent进程实现集群节点间的状态监控和数据同步。这个agent默认监听6666端口，采用长连接方式维持节点间通信。在正常卸载流程中，卸载程序应当自动终止所有相关进程并清理注册信息。但实际使用中发现，在某些特殊情况下（如强制终止卸载程序、系统资源不足等），会出现服务主体已卸载但agent进程残留的情况。
2. 问题诊断与验证步骤
2.1 确认端口占用情况
首先需要通过系统命令确认端口占用情况：
# Linux系统 netstat -tulnp | grep 6666 # 或使用更现代的ss命令 ss -ltnp | grep 6666 # Windows系统 netstat -ano | findstr 66662.2 定位残留进程信息
获取到占用6666端口的进程ID后，进一步确认是否为db_ha的agent：
# Linux系统 ps -ef | grep <PID> # 查看进程启动命令 cat /proc/<PID>/cmdline # Windows系统 tasklist | findstr <PID> wmic process where processid=<PID> get commandline典型特征包括：
- 进程路径包含"highgo"/"hgdb"等关键字
- 命令行参数中包含"db_ha_agent"或类似标识
- 工作目录位于瀚高安装路径下
2.3 检查服务注册情况
即使主程序已卸载，服务可能仍在系统中注册：
# Linux系统（systemd） systemctl list-units --all | grep highgo systemctl list-unit-files | grep highgo # Windows系统 sc query | findstr Highgo Get-WmiObject Win32_Service | Where-Object {$_.Name -like "*Highgo*"}3. 问题解决方案
3.1 标准清理流程
Linux环境操作步骤：
- 停止残留进程：
kill -9 <PID> - 清理systemd服务配置：
systemctl stop db_ha_agent systemctl disable db_ha_agent rm -f /usr/lib/systemd/system/db_ha_agent.service systemctl daemon-reload - 删除残留文件：
find / -name "*highgo*" -exec rm -rf {} \;
Windows环境操作步骤：
- 通过任务管理器或命令行终止进程：
taskkill /F /PID <PID> - 卸载服务：
sc delete db_ha_agent - 清理注册表：
reg delete "HKLM\SYSTEM\CurrentControlSet\Services\db_ha_agent" /f
3.2 特殊情况处理
当标准流程无效时，可能需要：
- 检查/var/run或/tmp目录下的socket文件
- 清理IPC资源：
ipcs -a | grep <user> ipcrm -a - 检查内核模块：
lsmod | grep highgo
4. 预防措施与最佳实践
4.1 安全卸载操作规范
- 卸载前完整备份数据
- 先停止所有相关服务：
systemctl stop highgo-server systemctl stop db_ha_agent - 使用官方卸载程序而非直接删除文件
- 在资源充足时段进行操作
4.2 安装配置建议
- 为agent进程配置专用账户
- 修改默认监听端口（通过db_ha.conf）
- 启用进程监控：
crontab -e */5 * * * * pgrep db_ha_agent || systemctl restart db_ha_agent
5. 深度技术解析
5.1 db_ha组件架构
瀚高高可用模块采用主从架构：
- Agent进程：负责心跳检测（每3秒一次）
- 仲裁服务：基于Paxos算法实现
- 数据同步：逻辑复制+物理WAL传输
5.2 端口占用根本原因
卸载过程中断导致：
- 进程终止信号未送达
- 服务注销回调未执行
- 文件锁未释放（特别是/var/lock下的.lock文件）
5.3 资源释放机制
完整释放需要：
- 关闭网络套接字
- 释放共享内存段
- 删除信号量
- 清理内存映射文件
6. 扩展知识：现代Agent技术
虽然与当前问题无直接关联，但近期热门的AI Agent技术也采用类似守护进程架构：
- 任务调度核心（类似db_ha_agent）
- 技能插件机制
- 消息总线通信
- 记忆持久化存储
这些系统的共同挑战包括：
- 优雅退出实现
- 资源泄漏防护
- 状态持久化一致性
7. 厂商特定建议
针对瀚高数据库：
- 官方已知问题单号：HGDB-2023-0477
- 推荐升级到V4.5.12+版本
- 提供专用清理工具hg_clean（需联系支持获取）
重要提示：生产环境操作前务必确认备份有效性，某些残留文件可能包含重要配置信息。