Windows下Maven环境中FreeTTS 1.2.2 VoiceManager类找不到异常的解决方法

问题根源 #

你遇到的NoClassDefFoundError本质是运行时JVM找不到FreeTTS的核心类文件——编译通过只说明编译阶段能访问到类，但运行时类路径（classpath）里没包含必要的FreeTTS依赖包。另外你代码里还有个小错误，下面一起解决。

修复步骤 #

1. 先修正代码里的低级错误 #

你原来的代码中，VoiceManager.getVoice("kelvin16")是错误的调用方式：getVoice是实例方法，不是静态方法，应该用你创建的voiceManager实例来调用。同时加上空指针判断和资源释放逻辑，避免后续崩溃：

package com.sewonet;

import com.sun.speech.freetts.VoiceManager;
import com.sun.speech.freetts.Voice;

public class App {
    public static void main(String[] args) throws Exception{
        VoiceManager voiceManager = VoiceManager.getInstance();
        Voice voice = voiceManager.getVoice("kelvin16"); // 改成实例调用
        if (voice != null) {
            voice.allocate(); // 必须先分配语音资源
            voice.speak("I love java");
            voice.deallocate(); // 使用完毕释放资源
        } else {
            System.err.println("找不到名为kelvin16的语音包，请确认依赖是否包含该语音");
        }
    }
}

2. 确保运行时类路径包含FreeTTS依赖 #

手动编译运行场景

假设你的编译后class文件在bin目录，FreeTTS的所有JAR包（包括核心包freetts.jar、语音包如cmu_us_kal.jar等）放在lib目录：

• Linux/macOS运行命令：

java -cp bin:lib/* com.sewonet.App

• Windows运行命令（把冒号换成分号）：

java -cp bin;lib/* com.sewonet.App

IDE（IntelliJ/Eclipse）场景

• 打开项目结构设置，将FreeTTS的所有JAR包添加为库依赖，确保依赖范围是Compile或Runtime（不要只在编译路径里添加）。
• 检查你的运行配置，确认类路径中已经包含所有FreeTTS相关的JAR包。

3. 确认语音包依赖 #

如果你指定的kelvin16语音无法找到，需要确保你已经引入了对应的语音包JAR（比如cmu_us_kal16.jar），不同的语音需要对应依赖包支持。

Maven管理依赖的补充 #

如果用Maven构建项目，直接添加以下依赖坐标即可自动处理类路径：

<dependency>
    <groupId>com.sun.speech</groupId>
    <artifactId>freetts</artifactId>
    <version>1.2.2</version>
</dependency>

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