I’ve been doing a lot of work with Maven recently, and having a miserable time of it.  Earlier this week I was ranting about it on a mailing list I was on, when I thought it would be therapeutic to try to list 100 things that irks me about Maven 2 that I’ve personally ran into.  So, I didn’t come close - I only came up with 25.  But I do feel much better now.

Here goes, in no particular order:

1. The Maven AntRun tasks allows you run ant from within Maven, but you have very limited access to the POM.
2. If you have a multi-module project configuration, changing the version of the root project requires you to change all the versions of the sub-modules
3. Maven Ant Tasks doesn’t resolve transitive dependencies exactly the same as a regular Maven project does.
4. Maven manages adding all the dependencies you need… and then some.  You end up probably spending the same amount of time having to exclude the dependencies you don’t need, especially in EAR/WAR setups
5. You pretty much have to declare the versions of every Maven plugin you use, or risk your build breaking when someone updates the plugin.
6. You can’t create a ‘macro goal’ that is a chain of multiple goals
7. Your custom plugins might not work if it is organized as a sub-module of a project.  Inexplicably, if you run the build inside that sub-module it works.  (Might just be a problem with Ant-based plugins)
8. Maven goes out of its way to not use Ant.  So, some things that work correctly in Ant don’t in Maven (for example, building GNU compliant tarball with the assembly plugin)
9. You can activate build profiles based on OS, file existence, and environment variables in Maven, but how do you disable them?
10. You can configure the build to deploy additional artifacts (e.g. javadoc and sources), but it won’t use the repository or snapshot repository configured for your project
11. Figuring out how a build works from reading plugin declarations is not easier than reading an Ant script
12. Good luck trying to find the artifact that you need to fix your NoClassDefFoundError
13. Passing Maven properties to your AntRun configuration?  Bah! who needs that?
14. What happened to my Maven 1.x pre/post-goals?  How is attaching plugins to build phases a better solution?
15. Multi-module projects is like having old school recursive Makefiles
16. Why can’t I define variables other than artifactId, groupId, and version to be substituted when building from an archetype?
17. Why can’t all the files in archetype-resources be included in the archetype?  Why do I have to define them all in an archetype.xml as well?
18. Versions of dependencies with classifiers are not be inheritable
19. Extending a build is difficult without creating a plugin, which requires creating yet another project
20. Customizations to the build always seems to take a few takes of trial and error before you can get them working.
21. Configurations specified for an Ant-based plugin doesn’t work if they’re specified at the execution level or the build profile level.  They will work if you specify them globally
22. Maintaining updates of plugins and what bugs are fixed in what version and what Maven version it’s compatible with is a PITA.
23. Documentation sucks.  Pretty much everything out there is surface deep.  There’s 50/50 chance that features that are skimmed over in the docs won’t work as expected
24. Why does the site:deploy and site:stage-deploy behave so differently for multi-module projects?
25. Why are build profiles inheritable?

So I imagine some of the explanation are vague, but my experience is that it is par for the course when you deal with builds in Maven.  Sometimes there’s seemingly no rhyme or reason for why things don’t work, and by the time you do find a workaround that does, you just don’t want to spend anymore time figuring why your previous approaches didn’t work.  I supposed the open source thing to do is to help fix the problem, but honestly, I just don’t love Maven that much.