在Eclipse中执行FitNesse测试用例，听起来并不复杂，但实际操作中不少人频频踩坑。许多新手刚上手就遇到“Class not found”或“Slim server startup failed”，面对满屏问号束手无策。实际上，只要理清几个关键环节，整个流程就能顺畅运行。
核心问题集中在三个方面：让Eclipse正确启动FitNesse服务、确保Fixture类能被正常加载、以及保证所有依赖路径干净无干扰。下面直接给出可操作的解决方案，不绕弯子。
准备FitNesse可执行jar与依赖
首先前往FitNesse官方GitHub页面下载最新稳定版，例如fitnesse-20240615.jar。建议避开旧版本，比如20140630这类早期版本，它们不仅无法兼容Ja va 11+，而且缺少Slim v3支持，使用后会带来更多麻烦。下载后解压，根目录下的fitnesse-*.jar包含全部核心依赖，其余文件并非必需。
将该jar复制到固定路径，比如D:\fitnesse\fitnesse.jar。切忌直接放入Eclipse项目的lib目录——否则在以Ja va Application方式启动时，类加载冲突会导致Wiki页面无法响应请求，编写好的测试全部失效。
随后在Eclipse中新建一个普通Ja va项目，命名为FitNesseRunner（无需使用Maven）。右键项目 → Build Path → Configure Build Path → Libraries → Add External JARs，选择刚刚放置的fitnesse.jar，完成依赖引入。
配置FitNesse启动主类
在FitNesseRunner项目中新建包fitnesse.runner，接着创建类MainLauncher。代码示例如下：
public class MainLauncher {
public static void main(String[] args) {
fitnesse.FitNesseMain.main(new String[]{
"-p", "8080",
"-d", "./fitnesse-root",
"-e", "0"
});
}
}
这里-d ./fitnesse-root表示FitNesse将从当前项目根目录下的fitnesse-root文件夹读取wiki页面。若该文件夹不存在，首次启动会自动创建并初始化默认首页。路径必须保持干净——不能包含中文、空格或任何特殊符号，否则Slim引擎解析路径时会崩溃，所有测试表格都会显示为“?Unknown Fixture?”。这一高频陷阱不少开发者都曾遇到。
右键该类 → Run As → Ja va Application，控制台输出Starting FitNesse on port: 8080即表示启动成功。此时在浏览器中访问http://localhost:8080，应能看到FitNesse首页，服务已处于待命状态。
集成Xebium或自定义Fixture
此处提供两种常见场景，可根据测试需求灵活选择。
方法一：使用Xebium进行Web UI测试
下载Xebium的release包，例如xebium-1.37.jar，放入FitNesseRunner/lib目录。然后在项目中配置Build Path，将该jar添加进去。之后在fitnesse-root文件夹里的任意wiki页面顶部，添加以下两行：
!define TEST_SYSTEM {slim}
!path lib/xebium-1.37.jar方法二：编写自定义Ja va Fixture
在FitNesseRunner项目中新建包myfixture，创建一个Calculator类，其中包含add(int a, int b)方法，返回a + b。编译后确保类文件出现在bin/目录下。然后wiki页面中按如下格式编写测试内容：
|import|
|myfixture|
|Calculator|
|a|b|result?|
|1|2|3|如果页面报错Could not find constructor for: myfixture.Calculator，说明该类未被Slim Classpath识别。此时需要在wiki页面顶部添加：!path bin——注意是bin目录，而不是src或当前目录.，这一细节最容易被忽略。
配置Eclipse运行参数以支持测试执行
此配置旨在解决调用链路的最后一步：确保启动环境能正确加载所有依赖。分为以下五个步骤：
第一步：右键MainLauncher.ja va → Run As → Run Configurations…
第二步：左侧双击Ja va Application新建一个运行配置，在Main标签页中确认Project为FitNesseRunner，Main class为fitnesse.runner.MainLauncher。
第三步：切换到Arguments标签页，在VM arguments中填入：-Dfile.encoding=UTF-8 -Xmx1024m。此项设置可避免中文乱码和内存不足问题。
第四步：切换到Environment标签页，点击New…，添加变量CLASSPATH，值设置为：
D:\fitnesse\fitnesse.jar;${workspace_loc:FitNesseRunner}/bin;${workspace_loc:FitNesseRunner}/lib/xebium-1.37.jar
第五步：点击Apply and Close保存。之后每次点击绿色运行按钮，即可完整启动FitNesse服务，并加载所有Fixture。不会再出现类加载失败或路径解析错误等烦人问题。
整个流程走下来，实质就是将几个关键依赖路径和环境变量配置准确。按此套路操作一次，后续可反复复用，几乎能够覆盖所有基于FitNesse的测试场景。