从手动添加jar包到使用Maven管理

最新推荐文章于 2025-05-14 13:59:59 发布

luwfls

最新推荐文章于 2025-05-14 13:59:59 发布

阅读量2k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： bug 文章标签： maven jfreechart

本文链接：https://blog.youkuaiyun.com/luwfls/article/details/56670882

bug 专栏收录该内容

1 篇文章

订阅专栏

本文分享了将传统SSH项目迁移到Maven的过程，包括解决依赖冲突、配置自定义仓库及排除多余依赖等技巧，并记录了从配置失误到版本兼容性问题的教训。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

背景介绍

近期接手了一个ssh架构的项目，项目没有使用maven管理，使用的传统手动添加jar包的方式，lib包有60Mb，考虑到以后项目的维护和发布，决定使用maven来管理。

pom构建

对照lib包里的jar去maven中央仓库查询坐标。中央仓库
注意有很多jar包并不在中央仓库，而是在其他仓库，这时需要配置该仓库到pom中。例如1.0.0.Final-redhat-1 仓库位于Redhat GA

仓库配置如下

<repository>
    <id>redhat-public</id>
    <name>redhat-public</name>
    <url>https://maven.repository.redhat.com/ga/</url>
</repository>

依赖冲突解决

通过idea绘制依赖解析图来分析依赖冲突。

排除依赖

<dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-email</artifactId>
   <version>1.3.3</version>
   <exclusions>
       <exclusion>
           <groupId>javax.mail</groupId>
           <artifactId>mail</artifactId>
       </exclusion>
   </exclusions>
</dependency>

至此项目构建完毕，使用IDEA重构了项目结构详见下图

构建好了Tomcat之后，点击启动，项目居然顺利启动，满心欢喜的点击了一下登录，结果爆炸了。所有涉及到与数据库交互的操作，都会抛出一个异常。如下：

严重: Servlet.service() for servlet [default] in context with path [] threw exception
org.springframework.beans.factory.NoSuchBeanDefinitionException: No bean named 'sessionFactory' is defined
    at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBeanDefinition(DefaultListableBeanFactory.java:641)
    at org.springframework.beans.factory.support.AbstractBeanFactory.getMergedLocalBeanDefinition(AbstractBeanFactory.java:1157)
    at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:280)
    at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:198)
    at org.springframework.context.support.AbstractApplicationContext.getBean(AbstractApplicationContext.java:979)
    at org.springframework.orm.hibernate4.support.OpenSessionInViewFilter.lookupSessionFactory(OpenSessionInViewFilter.java:191)
    at org.springframework.orm.hibernate4.support.OpenSessionInViewFilter.lookupSessionFactory(OpenSessionInViewFilter.java:176)
    at org.springframework.orm.hibernate4.support.OpenSessionInViewFilter.doFilterInternal(OpenSessionInViewFilter.java:127)
    at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)
    at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:220)
    at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:122)
    at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:501)
    at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:170)
    at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:98)
    at org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:950)
    at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)
    at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:408)
    at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1040)
    at org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:607)
    at org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:315)
    at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
    at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
    at java.lang.Thread.run(Thread.java:745)

stack-overflow解答
大概意思是OpenSessionInViewFilter这个东西（将 hibernate与数据库间的会话session的生命周期延长至Fileter控制范围，在此不做过多赘述）找不到sessionFactory，stack-overflow里面说的意思是sessionFactory这个bean配置的位置不对类似的云云，其实我遇到的问题不是这个。
我的解决方法，将Tomcat 7 换成 Tomcat 8
解决方法很简单，但是不知道为什么，希望有知道的朋友留言给我。

总结

项目重构时候一定要确定JDK版本、服务器（Tomcat）版本
为此走了很多弯路，详见下面BUGS，主要在sessionFactory找不到的问题上绞尽了脑汁。

BUGS

maven clean 已解决

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-clean-plugin:2.5:clean (default-clean) on project web: Failed to clean project: Failed to delete F:\ecotrans-web\target\web\WEB-INF\lib\struts2-core-2.3.16.3.jar -> [Help 1]

maven官方解释
可能导致的原因
- 执行clena的时候，tomcat服务器或JVM处于启动状态，关闭后再执行clean。

log4j:ERROR Could not parse url

log4j:WARN Parsing warning 2 and column 38  
log4j:WARN URI was not reported to parser for entity [dtd]  
log4j:WARN Parsing warning 2 and column 38  
log4j:WARN missing system ID, using log4j.dtd  
log4j:ERROR Could not parse url [file:/C:/Program%20Files/Apache%20Software%20Foundation/Tomcat%206.0/webapps/.../log4j.xml].  
gnu.xml.dom.DomEx: The operation violates XML Namespaces.  
More Information: xmlns is reserved  
Node Name: #document  
    at gnu.xml.dom.DomDocument.createAttributeNS(DomDocument.java:589)  
    at gnu.xml.dom.DomDocument.createAttribute(DomDocument.java:561)  
    at gnu.xml.dom.DomDocument.defaultAttributes(DomDocument.java:456)  
    at gnu.xml.dom.DomDocument.createElementNS(DomDocument.java:440)  
    at gnu.xml.pipeline.DomConsumer$Handler.startElement(DomConsumer.java:602)  
    at gnu.xml.dom.Consumer$Backdoor.startElement(Consumer.java:203)  
    at gnu.xml.pipeline.EventFilter.startElement(EventFilter.java:570)  
    at gnu.xml.pipeline.ValidationConsumer.startElement(ValidationConsumer.java:1177)  
    at gnu.xml.aelfred2.SAXDriver.startElement(SAXDriver.java:836)  
    at gnu.xml.aelfred2.XmlParser.parseElement(XmlParser.java:1037)  
    at gnu.xml.aelfred2.XmlParser.parseDocument(XmlParser.java:416)  
    at gnu.xml.aelfred2.XmlParser.doParse(XmlParser.java:167)  
    at gnu.xml.aelfred2.SAXDriver.parse(SAXDriver.java:320)  
    at gnu.xml.aelfred2.XmlReader.parse(XmlReader.java:294)  
    at gnu.xml.dom.JAXPFactory$JAXPBuilder.parse(JAXPFactory.java:186)  
    at org.apache.log4j.xml.DOMConfigurator$2.parse(DOMConfigurator.java:767)  
    at org.apache.log4j.xml.DOMConfigurator.doConfigure(DOMConfigurator.java:866)  
    at org.apache.log4j.xml.DOMConfigurator.doConfigure(DOMConfigurator.java:773)  
    at org.apache.log4j.helpers.OptionConverter.selectAndConfigure(OptionConverter.java:483)  
    at org.apache.log4j.LogManager.<clinit>(LogManager.java:127)  
    at org.apache.log4j.Logger.getLogger(Logger.java:104)  
    at com.letong.base.util.LogUtil.getLogger(LogUtil.java:20)  
    at com.letong.ltCoSystem.init.InitServlet.init(InitServlet.java:35)  
    at org.apache.catalina.core.StandardWrapper.loadServlet(StandardWrapper.java:1173)  
    at org.apache.catalina.core.StandardWrapper.load(StandardWrapper.java:993)  
    at org.apache.catalina.core.StandardContext.loadOnStartup(StandardContext.java:4187)  
    at org.apache.catalina.core.StandardContext.start(StandardContext.java:4496)  
    at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:791)  
    at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:771)  
    at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:546)  
    at org.apache.catalina.startup.HostConfig.deployDescriptor(HostConfig.java:637)  
    at org.apache.catalina.startup.HostConfig.deployDescriptors(HostConfig.java:563)  
    at org.apache.catalina.startup.HostConfig.deployApps(HostConfig.java:498)  
    at org.apache.catalina.startup.HostConfig.start(HostConfig.java:1277)  
    at org.apache.catalina.startup.HostConfig.lifecycleEvent(HostConfig.java:321)  
    at org.apache.catalina.util.LifecycleSupport.fireLifecycleEvent(LifecycleSupport.java:119)  
    at org.apache.catalina.core.ContainerBase.start(ContainerBase.java:1053)  
    at org.apache.catalina.core.StandardHost.start(StandardHost.java:785)  
    at org.apache.catalina.core.ContainerBase.start(ContainerBase.java:1045)  
    at org.apache.catalina.core.StandardEngine.start(StandardEngine.java:443)  
    at org.apache.catalina.core.StandardService.start(StandardService.java:519)  
    at org.apache.catalina.core.StandardServer.start(StandardServer.java:710)  
    at org.apache.catalina.startup.Catalina.start(Catalina.java:581)  
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)  
    at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)  
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)  
    at java.lang.reflect.Method.invoke(Unknown Source)  
    at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:289)  
    at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:414)  
log4j:WARN No appenders could be found for logger (chargingSystem).  
log4j:WARN Please initialize the log4j system properly.  
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.

解决方案
- Log4j和jfreechart同时存在时，如果使用了gnujaxp.jar包，则会出现该问题。
- 删除gnujaxp.jar的直接依赖，若果是用的是Maven并且使用了jfreechart需要如下配置。

<dependency>
    <groupId>jfree</groupId>
    <artifactId>jfreechart</artifactId>
    <version>1.0.11</version>
    <exclusions>
        <exclusion>
            <artifactId>gnujaxp</artifactId>
            <groupId>gnujaxp</groupId>
        </exclusion>
    </exclusions>
</dependency>

NoSuchBeanDefinitionException

该bean已经配置在applicationContext-resource.xml中，配置如下。

<bean id="sessionFactory" class="org.springframework.orm.hibernate4.LocalSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="configLocation" value="classpath:hibernate.cfg.xml"/>
    <property name="hibernateProperties">
        <value>
            hibernate.dialect=org.hibernate.dialect.MySQLDialect
            hibernate.query.substitutions=true '1', false '0'
            hibernate.cache.use_second_level_cache=false
            hibernate.show_sql=true
            hibernate.format_sql=true
            hibernate.hbm2ddl.auto=update
        </value> 
    </property>
</bean>

通过编写单元测试验证该配置文件没有问题

@RunWith(SpringJUnit4ClassRunner.class)  //使用junit4进行测试
@ContextConfiguration("classpath*:/applicationContext-*.xml")
public class HibernateSessionFactoryTest {
    @Autowired
    SessionFactory sessionFactory;

    @Test
    public void testSessionFactoryBean(){
        Session session = sessionFactory.openSession();
        session.get(Company.class,1);
        System.out.println(sessionFactory);
    }
}

Hibernate会自动生成表，见配置hibernate.hbm2ddl.auto=update，但是需要注意的是，必须数据库先存在hibernate才会自动见表。
排除配置文件问题，再排查web.xml配置文件引入是否存在问题。引入配置如下，

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext*.xml</param-value>
</context-param>

将classpath:applicationContext*.xml 修改为 classpath:applicationContext-resources.xml ，单独的只引入配置sessionFactoryBean的配置文件。再次启动项目果然出现了另外一个错误。java.lang.NoSuchMethodError:javax.persistence.Table.indexes() 错误如下。

Caused by: java.lang.NoSuchMethodError: javax.persistence.Table.indexes()[Ljavax/persistence/Index;
    at org.hibernate.cfg.annotations.EntityBinder.processComplementaryTableDefinitions(EntityBinder.java:936)
    at org.hibernate.cfg.AnnotationBinder.bindClass(AnnotationBinder.java:824)
    at org.hibernate.cfg.Configuration$MetadataSourceQueue.processAnnotatedClassesQueue(Configuration.java:3788)
    at org.hibernate.cfg.Configuration$MetadataSourceQueue.processMetadata(Configuration.java:3742)
    at org.hibernate.cfg.Configuration.secondPassCompile(Configuration.java:1410)
    at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:1844)
    at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:1928)
    at org.springframework.orm.hibernate4.LocalSessionFactoryBuilder.buildSessionFactory(LocalSessionFactoryBuilder.java:343)
    at org.springframework.orm.hibernate4.LocalSessionFactoryBean.buildSessionFactory(LocalSessionFactoryBean.java:431)
    at org.springframework.orm.hibernate4.LocalSessionFactoryBean.afterPropertiesSet(LocalSessionFactoryBean.java:416)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1612)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1549)
    ... 59 more

stack overflow 解答
大概意思是，如果hibernate实体类映射时使用了@Table注解，则hibernate-jpa 必须是2.1版本，通过检查Maven依赖关系发现hibernate-tools 依赖的是hibernate-jpa-2.0 将该依赖排除，该问题解决。

<dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-tools</artifactId>
            <version>3.6.0.CR1</version>
            <exclusions>
             <exclusion>
                    <groupId>org.hibernate.javax.persistence</groupId>
                    <artifactId>hibernate-jpa-2.0-api</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

现在将classpath:applicationContext*.xml 还原，再次验证sessionFactory找不到的问题，仍然出现。然后我使用该项目的原始开发工具NetBeans构建该项目，控制台打印的错误果然详细了很多，详见：

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'sessionFactory' defined in file [F:\src-ecotrans-all-20170130\build\web\WEB-INF\classes\applicationContext-resources.xml]: Cannot resolve reference to bean 'dataSource' while setting bean property 'dataSource'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'dataSource' defined in file [F:\src-ecotrans-all-20170130\build\web\WEB-INF\classes\applicationContext-resources.xml]: Initialization of bean failed; nested exception is java.lang.IllegalArgumentException: error at ::0 can't find referenced pointcut aspect
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveReference(BeanDefinitionValueResolver.java:336)
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveValueIfNecessary(BeanDefinitionValueResolver.java:108)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.applyPropertyValues(AbstractAutowireCapableBeanFactory.java:1456)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.populateBean(AbstractAutowireCapableBeanFactory.java:1197)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:537)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:475)
    at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:302)
    at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:228)
    at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:298)
    at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:193)
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveReference(BeanDefinitionValueResolver.java:328)
    ... 63 more
Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'dataSource' defined in file [F:\src-ecotrans-all-20170130\build\web\WEB-INF\classes\applicationContext-resources.xml]: Initialization of bean failed; nested exception is java.lang.IllegalArgumentException: error at ::0 can't find referenced pointcut aspect
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:547)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:475)
    at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:302)
    at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:228)
    at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:298)
    at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:193)
    at org.springframework.beans.factory.support.BeanDefinitionValueResolver.resolveReference(BeanDefinitionValueResolver.java:328)
    ... 73 more
Caused by: java.lang.IllegalArgumentException: error at ::0 can't find referenced pointcut aspect
    at org.aspectj.weaver.tools.PointcutParser.parsePointcutExpression(PointcutParser.java:315)
    at org.springframework.aop.aspectj.AspectJExpressionPointcut.buildPointcutExpression(AspectJExpressionPointcut.java:206)
    at org.springframework.aop.aspectj.AspectJExpressionPointcut.checkReadyToMatch(AspectJExpressionPointcut.java:192)
    at org.springframework.aop.aspectj.AspectJExpressionPointcut.getClassFilter(AspectJExpressionPointcut.java:169)
    at org.springframework.aop.support.AopUtils.canApply(AopUtils.java:208)
    at org.springframework.aop.support.AopUtils.canApply(AopUtils.java:262)
    at org.springframework.aop.support.AopUtils.findAdvisorsThatCanApply(AopUtils.java:294)
    at org.springframework.aop.framework.autoproxy.AbstractAdvisorAutoProxyCreator.findAdvisorsThatCanApply(AbstractAdvisorAutoProxyCreator.java:118)
    at org.springframework.aop.framework.autoproxy.AbstractAdvisorAutoProxyCreator.findEligibleAdvisors(AbstractAdvisorAutoProxyCreator.java:88)
    at org.springframework.aop.framework.autoproxy.AbstractAdvisorAutoProxyCreator.getAdvicesAndAdvisorsForBean(AbstractAdvisorAutoProxyCreator.java:69)
    at org.springframework.aop.framework.autoproxy.AbstractAutoProxyCreator.wrapIfNecessary(AbstractAutoProxyCreator.java:376)
    at org.springframework.aop.framework.autoproxy.AbstractAutoProxyCreator.postProcessAfterInitialization(AbstractAutoProxyCreator.java:339)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.applyBeanPostProcessorsAfterInitialization(AbstractAutowireCapableBeanFactory.java:421)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1558)
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:539)
    ... 79 more

error at ::0 can’t find referenced pointcut XXX网上说是aspectjweaver.jar 和aspectjrt.jar这两个jar包与JDK1.7不匹配。我查看了一下NeatBeans使用的配置是JDK1.8、Tomcat8，在此同时我同事使用Eclipse成功启动了Maven构建的项目，我又询问了一下原项目组的同事，他们开发的时候使用的是JDK1.8、Tomcat8，至此恍然大悟，不是项目的问题，而是JDK和Tomcat版本问题，后来使用JDK1.7+Tomca8也没有问题，使用Tomcat7就会出现该问题，希望了解个问题原因的朋友给我留言，谢谢。

maven 插件

maven-compiler-plugin

指定编译器版本

     <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>

org.apache.maven.plugins

跳过单元测试类，有很多时候在打包的时候不希望运行单元测试类。可参考如下配置

 <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <configuration>
                    <skip>true</skip>
                </configuration>
            </plugin>