Maven报错${name}已废弃需替换为${project.name}，求助排查方案

错误原因 #

该报错是因为Maven中直接使用${name}引用项目名称的写法已被官方废弃，要求统一改用${project.name}。旧写法会影响构建稳定性，后续Maven版本可能彻底停止支持此类项目构建。

排查步骤（无需分享pom.xml） #

• 遍历项目所有pom文件（父pom、子模块pom），全局搜索${name}，检查是否在properties、插件配置、依赖管理等节点中使用了该变量
• 执行mvn help:effective-pom命令生成完整的有效pom文件，该文件会合并所有继承、引入的配置，搜索其中的${name}即可定位到隐藏的引用来源（比如第三方依赖或插件的内部配置）
• 检查项目的maven profile配置，确认各个profile中是否存在${name}的引用
• 排查本地或公司的maven settings.xml文件，检查其中的mirror、server、profile等配置是否用到了${name}

解决办法 #

• 将所有找到的${name}替换为${project.name}
• 若发现是第三方依赖/插件内部使用了过时写法，尝试升级该依赖/插件的版本，新版本通常会修复此类问题
• 替换完成后执行mvn clean install验证构建是否恢复正常

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