问题背景与现象 #

根据你的描述，核心问题与环境信息如下：

• 环境：TDengine 3.4.0.0，Docker容器化单节点集群，Linux系统
• 核心矛盾：反复删除/重建数据库、重新导入数据后，SHOW DATABASES返回的disk_info仅为104GB，但VNODE目录（/var/lib/taos/vnode/）实际占用800GB，导致磁盘耗尽
• 已尝试操作：删除重建数据库、重新摄取数据，但磁盘空间未有效回收

可能的原因 #

1. VNODE延迟清理机制：TDengine删除数据库时，不会立即物理删除VNODE文件，而是标记为待清理，等待后台线程异步回收（默认存在延迟）
2. 孤立VNODE文件残留：多次删库操作可能因服务中断、容器异常重启等，导致部分VNODE元数据被清理，但物理文件未被删除，形成"孤儿文件"
3. 容器文件系统特性：Docker的overlay2等存储驱动可能存在磁盘空间延迟释放问题，即使文件被删除，宿主机空间不会立即回收
4. 版本特定缺陷：TDengine 3.4早期版本可能存在删库后VNODE清理逻辑的bug，导致空间无法自动回收

分步解决方案 #

方法1：使用官方内置清理工具taoscleanup（推荐） #

TDengine提供了专门用于清理孤立VNODE文件的工具，这是最安全的内置解决方案：

1. 进入Docker容器：

   docker exec -it <你的TDengine容器ID/名称> bash
   

2. 停止TDengine服务（清理前必须停止，避免数据损坏）：

   systemctl stop taosd
   # 若容器内无systemctl，可直接杀死进程：killall taosd
   

3. 执行清理工具：

   taoscleanup -d /var/lib/taos
   

   • 参数-d指定TDengine根数据目录，默认路径为/var/lib/taos
   • 该工具会自动扫描VNODE文件与元数据的关联关系，删除无对应数据库的孤立文件
4. 重启TDengine服务：

   systemctl start taosd
   

方法2：手动验证并清理孤立VNODE文件（需谨慎操作） #

如果taoscleanup未完全解决问题，可手动验证后清理：

1. 获取当前所有活跃VNODE的ID：
   在TDengine客户端中执行SQL：

   SELECT vnode_id FROM information_schema.vnodes;
   

2. 列出VNODE目录下的所有文件夹：

   ls -l /var/lib/taos/vnode/
   

   每个VNODE文件夹命名格式为vnode_<数字ID>
3. 删除未出现在活跃列表中的VNODE文件夹：
   对比SQL返回的ID与目录中的文件夹，删除孤立的文件夹：

   rm -rf /var/lib/taos/vnode/vnode_<孤立ID>
   

   重要提示：务必确认这些VNODE确实没有关联的数据库，否则会导致不可逆的数据丢失！

方法3：解决容器文件系统的空间延迟释放问题 #

若空间未回收是Docker存储驱动导致的，需在宿主机执行以下操作：

1. 检查Docker资源占用情况：

   docker system df
   

2. 清理Docker未使用的资源：

   docker system prune -a
   

3. 强制回收overlay2文件系统空间：
   进入容器后执行（需容器支持fstrim命令）：

   fstrim /var/lib/taos
   

方法4：配置TDengine自动清理参数（预防未来问题） #

修改TDengine配置文件taos.cfg，调整VNODE清理的相关参数：

• vnode_cleanup_interval：设置后台清理线程的执行间隔（默认3600秒，可改为300秒加快清理频率）
• vnode_inactive_threshold：设置VNODE被标记为待清理的inactive时间阈值
  修改后重启TDengine服务生效。

验证步骤 #

1. 验证数据库disk_info：

   SHOW DATABASES;
   

2. 验证VNODE目录大小：

   du -sh /var/lib/taos/vnode/
   

3. 验证宿主机磁盘使用情况：

   df -h
   

确认三者数据一致，磁盘空间已被有效回收。

长期预防措施 #

• 避免频繁删除/重建数据库，改用TRUNCATE TABLE或DROP TABLE清理数据（仅需清空数据时）
• 定期执行taoscleanup工具（可加入容器内的定时任务）
• 升级TDengine到最新稳定版本（后续版本可能修复了该清理逻辑的缺陷）
• 监控VNODE目录大小与数据库disk_info的差异，提前预警空间异常