Gradle: Spring + FatJar = dependency on Internet connection

See my recent blog post for FatJar configuration sample. Today I found nasty behavior of Gradle plugin FatJar when used on Spring project. I hope that this post will help you not to spend whole day with it - as I did.

If your project uses only one version of each library, java packages system should assure that there will be no conflicts when merging multiple jar libraries into one big. But that does not apply to directory META-INF. This directory typically does not use packages system, so conflicts may appear.

FatJar plugin handles this situation in simple way - it just copies each file in multiple versions:


That - of course - causes issues when loading. Typically only one file is picked. For example Spring stores in spring.schemas paths in resources where XSD schema files referred from your beans.xml are located in resources (so it does not need to load it from Internet). But do that for each module - Context, AOP, Web, … So only one module works.

This problem does not appear on machine with available Internet connection, because it just downloads schemas from addresses like But when you deploy your app on intranet server, problem appears:

143306.358000 2016-01-26 [ main] [ WARN] [factory.xml.XmlBeanDefinitionReader] [] : Ignored XML validation warning org.xml.sax.SAXParseException: schema_reference.4: Failed to read schema document '', because 1) could not find the document; 2) the document could not be read; 3) the root element of the document is not <xsd:schema>.
Caused by: 
at ~[?:1.8.0_72-internal] 
at ~[?:1.8.0_72-internal] 
at ~[?:1.8.0_72-internal] 
at ~[?:1.8.0_72-internal] 

And then:

Exception in thread <main> org.springframework.beans.factory.xml.XmlBeanDefinitionStoreException: Line 6 in XML document from class path resource [grab_mode_beans.xml] is invalid; nested exception is org.xml.sax.SAXParseException; lineNumber: 6; columnNumber: 69; cvc-elt.1: Cannot find the declaration of element 'beans'. at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.doLoadBeanDefinitions( 
Caused by: org.xml.sax.SAXParseException; lineNumber: 6; columnNumber: 69; cvc-elt.1: Cannot find the declaration of element 'beans'. 

Solution is to use shadowJar. It may look like this:

buildscript { 
    repositories {
        maven { 
            url "" 
    dependencies { 
        classpath 'com.github.jengelman.gradle.plugins:shadow:1.2.2' 

apply plugin: 'com.github.johnrengelman.shadow' 

dependencies { 
    compile project(":MyOwnProjectExample") 

shadowJar { 
    archiveName "MyTest.jar"; 
    manifest { attributes("Main-Class": "" ) } 

//this helps if you like to build fatJar as part of normal build 
//otherwise use "gradle shadowJar"; 
assemble.dependsOn shadowJar 
build.dependsOn shadowJar

I already suffered at least by 3 similar issues with following libraries:

  • Spring
  • Log4j2
  • Lucene

I hope it helps!

Tags:  Gradle  Java  FatJar  Spring 
Last blog articles:
Mým fuckupům
Ubuntu: Login loop
Leaving LinkedIn
LinkedIn: Odcházení
git gui: Add pull and stash commands

Java Ubuntu česky Gradle personal Software-architecture DIY children React Eclipse DisplayLink AI Spring JavaScript AspectJ neuron SSH LXC JavaFX Immutables Gnome3 GIT FatJar Edison technologies startup science procrastination pokusy podnikání linux lambda kvas ellipsis destilace chemie alkohol VisualVM Upstart Tomcat Selenium REST PrimeFaces Log4j Jooq Jackson JSF Debug DI CSS

Last tweets: