TestNG异常排查：类路径找不到PutAway类（Maven转普通Java项目）

你把Maven项目转为普通Java项目后遇到了TestNG无法定位PutAway类的问题，这大概率是类路径或编译配置在转换过程中出了问题，我整理了几个实用的排查和解决步骤：

1. 先确认代码是否正常编译 #

Maven会自动管理编译后的class文件位置，但转成普通项目后Eclipse的编译配置可能混乱了：

• 右键项目 → 「Properties」→ 「Java Build Path」→ 切换到「Source」标签页
• 检查你的源码文件夹（比如src/main/java或src/test/java）对应的「Output folder」是否正确，一般是bin或者原Maven结构的target/classes
• 手动触发一次构建：右键项目 → 「Build Project」，然后去对应的输出目录里找有没有PutAway.class文件，如果没有，说明代码没编译成功，得先解决编译问题（比如检查有没有语法错误）

2. 检查TestNG XML配置的类名是否完整 #

打开你的TestNG配置文件（比如testng.xml），找到引用PutAway的那一行：

• 必须填写完整的全限定类名，比如你的类在com.yourproject.tests包下，就得写成<class name="com.yourproject.tests.PutAway"/>，不能只写PutAway
• 仔细检查拼写，包名和类名的大小写、字母有没有写错

3. 确保项目类路径包含编译输出目录 #

普通Java项目需要手动把编译后的class目录加入类路径：

• 右键项目 → 「Properties」→ 「Java Build Path」→ 「Libraries」标签页
• 点击「Add Class Folder」，选择你的编译输出目录（比如bin），把它添加进去，这样TestNG才能找到编译后的class文件

4. 验证TestNG依赖的完整性 #

虽然你说已经添加了所有必要jar包，但还是要确认：

• 你添加的TestNG jar版本和日志里的6.8.2一致，避免版本冲突
• jar文件没有损坏，可以删掉现有TestNG jar，重新下载6.8.2版本的jar包添加到项目中

5. 彻底清理重建项目 #

有时候Eclipse的缓存会导致奇怪的问题，试试这个：

• 右键项目 → 「Clean...」，清理项目后再点击「Build Project」
• 如果之前的Maven残留文件还在，可以手动删除target或bin目录，然后重新构建项目

附你遇到的错误日志： #

[RemoteTestNG] detected TestNG version 6.8.2
org.testng.TestNGException: Cannot find class in classpath: PutAway
    at org.testng.xml.XmlClass.loadClass(XmlClass.java:81)
    at org.testng.xml.XmlClass.init(XmlClass.java:73)
    at org.testng.xml.XmlClass.<init>(XmlClass.java:59)
    at org.testng.xml.TestNGContentHandler.startElement(TestNGContentHandler.java:543)
    at com.sun.org.apache.xerces.internal.parsers.AbstractSAXParser.startElement(AbstractSAXParser.java:509)
    at com.sun.org.apache.xerces.internal.impl.dtd.XMLDTDValidator.startElement(XMLDTDValidator.java:745)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanStartElement(XMLDocumentFragmentScannerImpl.java:1359)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl$FragmentContentDriver.next(XMLDocumentFragmentScannerImpl.java:2784)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl.next(XMLDocumentScannerImpl.java:602)
    at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanDocument(XMLDocumentFragmentScannerImpl.java:505)
    at com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(XML11Configuration.java:842)
    at com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(XML11Configuration.java:771)
    at com.sun.org.apache.xerces.internal.parsers.XMLParser.parse(XMLParser.java:141)
    at com.sun.org.apache.xerces.internal.parsers.AbstractSAXParser.parse(AbstractSAXParser.java:1213)
    at com.sun.org.apache.xerces.internal.jaxp.SAXParserImpl$JAXPSAXParser.parse(SAXParserImpl.java:643)
    at com.sun.org.apache.xerces.internal.jaxp.SAXParserImpl.parse(SAXParserImpl.java:327)
    at javax.xml.parsers.SAXParser.parse(SAXParser.java:195)
    at org.testng.xml.SuiteXmlParser.parse(SuiteXmlParser.java:17)
    at org.testng.xml.SuiteXmlParser.parse(SuiteXmlParser.java:10)
    at org.testng.xml.Parser.parse(Parser.java:172)
    at org.testng.TestNG.initializeSuitesAndJarFile(TestNG.java:311)
    at org.testng.remote.AbstractRemoteTestNG.initialize(AbstractRemoteTestNG.java:137)
    at org.testng.remote.AbstractRemoteTestNG.run(AbstractRemoteTestNG.java:98)
    at org.testng.remote.RemoteTestNG.initAndRun(RemoteTestNG.java:251)
    at org.testng.remote.RemoteTestNG.main(RemoteTestNG.java:77)

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