HarmonyOS鸿蒙Next中真机测试moduleName is not unique记录（已更正有误理解）
HarmonyOS鸿蒙Next中真机测试moduleName is not unique记录（已更正有误理解） 更正附在文末
设备系统版本：6.0.0
deveco studio版本：6.0.2.640
设备是刚买的，第一次进行真机测试，报错moduleName is not unique，但是之前在模拟器上可以正常测试。报错截图如下：
根据提示检查，并没发现模块重名，后来检查其他设置，发现其中一个模块没有勾选多模块依赖，截图如下：
勾选上，依次点击应用、确认按钮即可。
在后期测试中，有个细节。当只要成功在真机上调试过一次后，即使取消多模块依赖选项，也可以进行正常测试。但是当把真机上的程序卸载后，再次调试时会报错。猜测是因为这个模块是库模块，调试后，真机上已经有这个模块的包了，再次调试时，这个模块未作任何修改，因此没有重新编译，所以不报错。
后来遇到勾选了也会报这个错，选中报错的那个模块，单独调试一下，然后再选中entry模块调试即可。
调试按钮如下截图，在1处选择报错模块，然后点击2处按钮，不报错，然后选择主模块调试。
更正
上面的描述，对官方文档理解不仔细，看过文档后，重新记录。参考文档（https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-debug-configurations）
之所以出现moduleName is not unique这个问题，是因为，在多模块调试配置中，相互调用的entry和feature模块同依赖的HAR/HSP模块的调试配置是分开的。即依赖的模块需要使用自动安装依赖，不能同时在调试配置中手动配置，如下截图：
1是HSP模块，需要在2模块中勾选auto dependencies。
不需要在多模块依赖中再选择，这样就会造成重复配置，编译器会认为是两个名字一样的独立模块，不符合名称唯一性要求。这种情况在直接勾选ALL Modules时最常出现，所以建议所有模块都取消All Module选项，手动添加。
更多关于HarmonyOS鸿蒙Next中真机测试moduleName is not unique记录（已更正有误理解）的实战教程也可以访问 https://www.itying.com/category-93-b0.html
👍👍
更多关于HarmonyOS鸿蒙Next中真机测试moduleName is not unique记录（已更正有误理解）的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
在HarmonyOS Next真机测试中，moduleName不唯一错误通常是由于HAP模块的moduleName配置重复导致。请检查项目内所有模块的module.json5配置文件，确保每个模块的"moduleName"字段值具有唯一性。该错误会直接影响应用的正常安装与运行。
感谢分享这个详细的排查和更正过程。你遇到并解决的 moduleName is not unique 问题，确实是 HarmonyOS Next 多模块项目真机调试时的一个典型配置问题。
你的更正部分完全正确，核心在于理解 HAR/HSP 依赖模块 与 可独立运行的 Entry/Feature 模块 在调试配置上的区别。
总结你的解决方案要点：
- 根本原因：在运行/调试配置中，手动添加了已被其他模块依赖的 HAR/HSP 模块，导致系统在安装时识别到两个同名的模块实例，违反了唯一性约束。
- 正确配置：对于被依赖的 HAR/HSP 模块，不应在 “Deploy Multi HAPs” 列表中手动添加。正确的做法是在依赖它的主模块（如 Entry）配置中，勾选 “Auto add dependencies” 选项。这样 DevEco Studio 会自动处理依赖模块的编译和部署，避免重复。
- 实用技巧：你提到的避免使用 “All Modules” 而采用手动精选需要部署的模块，是一个很好的实践，可以更精确地控制部署内容，防止自动包含不必要的模块造成冲突。
你的经历清晰地展示了从现象（报错）到官方文档排查，再到深入理解配置逻辑并找到最佳实践的过程。这个记录对于其他遇到相同问题的开发者非常有参考价值，尤其是关于“自动添加依赖”与“手动多模块部署”之间区别的实践说明。
