MapStruct Spring Boot报错：无法找到关联属性问题排查

核心原因 #

这个错误的根源在于Java编译默认不保留方法参数名到字节码中，MapStruct的静态代码分析（包括IDE插件的检查逻辑）依赖参数名信息来识别source="entity.id"这类写法里参数与类型属性的关联：

• 当你写source="entity.id"时，IDE的MapStruct检查工具或注解处理器在静态分析阶段，无法从字节码中获取到entity这个参数名对应的是Employee类型，因此无法确认id属性的存在，从而抛出"Can't find related attribute"提示。
• 而直接写source="id"时，MapStruct会自动从方法的输入参数类型（Employee）中匹配同名属性，这是它的默认匹配逻辑，不需要依赖参数名，因此能正确生成映射代码并正常运行。

解决方式 #

如果偏好使用参数名.属性名的写法，可以通过以下方式修复：

• 启用Java编译时保留参数名：在Maven或Gradle的编译配置中添加-parameters参数，让字节码保留方法参数名。以Maven为例，修改pom.xml的编译插件配置：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.8.1</version>
              <configuration>
                  <compilerArgs>
                      <arg>-parameters</arg>
                  </compilerArgs>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

• 继续使用直接写属性名的简洁写法：这是MapStruct推荐的方式，只要属性名在输入参数的类型中存在，就能自动完成映射，无需额外配置。

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