Spring MVC类路径扫描I/O失败(<component-scan>)，JBoss5部署求助

作为刚入坑Spring时也踩过类似JBoss部署坑的过来人，咱们一步步来排查解决这个问题：

一、先把项目结构的基础问题摸清楚 #

你提到Controller组件在JAR里，先确认这几个细节：

• 装着Controller的JAR包必须放在WAR的WEB-INF/lib目录下，JBoss 5只会扫描这个路径下的JAR来加载Spring组件，别放错地方了
• 检查<component-scan>的base-package配置是否准确，比如你的Controller在com.test.controller包下，标签得写对：

<context:component-scan base-package="com.test.controller" />

包名写错是新手最容易犯的低级错误，别大意！

二、解决JBoss 5的类加载冲突 #

JBoss 5自带了老旧的Spring类，很容易和你项目里的Spring版本打架，这也是扫描I/O失败的常见原因：

• 在WAR的WEB-INF目录下新建jboss-web.xml，添加类加载隔离配置，让JBoss优先用你项目里的Spring类：

<jboss-web>
    <class-loading java2ClassLoadingCompliance="false">
        <loader-repository>
            com.test:archive=TestJsp.war
            <loader-repository-config>java2ParentDelegation=false</loader-repository-config>
        </loader-repository>
    </class-loading>
</jboss-web>

• 确保你的Spring版本和JBoss 5兼容，Spring 3.2.x系列是和JBoss 5适配最好的稳定版本，别用太新的Spring版本。

三、排查文件权限与资源损坏问题 #

I/O失败也可能是JBoss读不了你的JAR文件：

• 如果是Linux系统，给JBoss运行用户赋予WAR解压后WEB-INF/lib目录下所有JAR的读权限
• 重新打包你的Controller JAR，检查有没有编译错误，打包时是不是漏了Controller类，损坏的JAR也会导致扫描失败

四、拿完整错误日志定位问题 #

你只贴了部分启动日志，完整的异常栈才是关键：

• 去JBoss安装目录的server/default/log/server.log里找包含I/O failure during classpath scanning的完整报错信息，看看是哪个JAR读不了，还是类加载器找不到指定包

最后给你个小技巧：启动JBoss时加上-verbose:class参数，能看到类加载的详细过程，方便你定位到底是哪个环节出了问题。

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