使用SchemaCrawler生成PostgreSQL数据库schema图时遇指定类错误

这个错误本质是Graphviz相关的依赖缺失、版本不兼容，或者系统环境没正确配置导致的，以下是针对性的解决步骤：

• 检查Graphviz系统安装与环境变量
  首先确保你的系统已经安装了Graphviz：

  • Windows：用Chocolatey安装choco install graphviz，或者从官网下载安装包
  • Linux：Debian/Ubuntu用apt-get install graphviz，CentOS/RHEL用yum install graphviz
  • macOS：用Homebrew安装brew install graphviz
    安装完成后，在终端运行dot -V，能正常输出版本号说明安装有效。同时要确认Graphviz的bin目录已经加入系统PATH环境变量，否则SchemaCrawler无法找到dot命令。

• 确认SchemaCrawler的Graphviz依赖兼容性
  这个错误大多和SchemaCrawler依赖的nidi/graphviz库版本冲突有关：

  • 如果用的是命令行版SchemaCrawler，务必下载完整带依赖的包，不要选择轻量精简版
  • 如果是通过Maven/Gradle引入的，检查依赖配置，排除冲突的nidi/graphviz版本，指定与当前SchemaCrawler版本兼容的版本（比如SchemaCrawler 16.x通常兼容0.13.0左右的nidi/graphviz）

• 修正SchemaCrawler命令参数
  确保命令中指定的输出格式是Graphviz支持的类型，比如png、svg，避免使用不兼容的格式。示例PostgreSQL命令：

  schemacrawler \
    -server postgresql \
    -host localhost \
    -port 5432 \
    -database your_database_name \
    -user your_username \
    -password your_password \
    -infolevel standard \
    -outputformat png \
    -outputfile database_schema.png
  

• 清理依赖缓存（针对构建工具场景）
  如果是在Maven/Gradle项目中使用，可能是缓存的依赖损坏导致的：

  • Maven：执行mvn clean install -U强制更新依赖
  • Gradle：执行gradle clean build --refresh-dependencies刷新依赖

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