MapStruct 1.3.1.Final bug fix released

It is my pleasure to announce the 1.3.1.Final bug fix release of MapStruct. Since the Final release of MapStruct 1.3.0.Final we have received amazing feedback from the community.

This release includes 3 enhancements, 12 bug fixes and 7 documentation improvements.

The enhancements include:

  • Ability to disable builders on method level via Builder#disableBuilder
  • Stricter matching for lifecycle methods / non-unique parameters

Altogether, not less than 21 issues were fixed for this release.

What’s inside

First and foremost we fixed almost all the bugs reported by the community for the 1.3.0.Final release. Apart from bug fixes we added some small enhancements.

Ability to disable builder on method level

It is now possible to disable the usage of Builders via the Builder#disableBuilder option. This is useful if you want to tell MapStruct no to use builders when mapping your beans.

Stricter matching for lifecycle methods / non-unique parameters

In case a lifecycle method has multiple matching parameters (e. g. same type) all parameter names must match exactly with the ones from the mapping method, otherwise the lifecycle method will not be used and a warning will be shown.

Welcome Andrei to the MapStruct team

Since our last release we also have a new member join our small MapStruct team. We are happy to say welcome to Andrei Arlou. He has been busy answering questions, improving our codebase, fixing bugs and working on different enhancements for our next release.


We are very proud and thankful of our of our growing community. Recently we passed the 2000 stargazers milestone on GitHub.

Most impressive though are the download numbers we get from the Maven Central repo. They have doubled since our last release and we have seen an amazing rate of our users upgrading to the latest release. As an example here are the numbers for the org.mapstruct:mapstruct-processor artifact:

Happy coding with MapStruct 1.3!!


You can fetch the new release from Maven Central using the following GAV coordinates:

Alternatively, you can get ZIP and TAR.GZ distribution bundles - containing all the JARs, documentation etc. - from GitHub.

If you run into any trouble or would like to report a bug, feature request or similar, use the following channels to get in touch:

comments powered by Disqus