编译报错“Cannot read properties of undefined (reading 'split')”
===========================================================

*   场景一：
    
    **问题现象**
    
    当前使用的DevEco Studio版本与SDK版本不配套，导致DevEco Studio抛出异常：“TypeError: Cannot read properties of undefined (reading 'split')”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/4bSnVDI-ShKpGPyUDUzG7g/zh-cn_image_0000002264138776.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=735D4539B455AD8BF89E5F1B0547365649E5AD9EF1388B1423C075F1F90C695B)
    
    **解决措施**
    
    1.  访问华为[开发者官网](https://developer.huawei.com/consumer/cn/download/deveco-studio)下载最新版DevEco Studio。
    2.  使用新版本DevEco Studio打开待迁移项目。
    3.  根据DevEco Studio自动弹出的迁移提示进行操作。
        
        *   点击“Migrate Assistant”功能。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/25/v3/cKI-zKEVTKar0zVSQ7BDww/zh-cn_image_0000002264083104.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=3BC7331F3E7A61C3E740185DF97C85647A0B95BF66546C5A9CCDE28D8A4E8CFB)
        
        *   从版本列表中选择目标迁移版本。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f3/v3/bPsiLFnJR3a2Ytms0eIFCw/zh-cn_image_0000002264081160.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=4594D2B5CF261465A2AD5A5273784C71E4A58F0703C6B3218560DBC4C4896479)
        
        *   按照向导完成项目迁移流程。
        
*   场景二：
    
    **问题现象**
    
    当工程级 build-profile.json5 文件未配置工程外模块依赖，而模块级 oh-package.json5 声明了工程外模块依赖并在代码中实际引用时，编译阶段会抛出异常：”Error: Cannot read properties of undefined (reading 'split')”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4f/v3/SUrbOCgJQNehGlAVASqDpw/zh-cn_image_0000002264140556.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=A9D13F9916E5E3F4C603E1F4E826E000C126411089FA7EAEB4E09C7F4A730EA2)
    
    **解决措施**
    
    1.  检查下报错子模块中所引用的依赖，确保目标模块已在工程级 build-profile.json5 文件的 modules 字段中正确声明。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/77/v3/Xzyh78gIRMeIv3WKcZG_mQ/zh-cn_image_0000002264140648.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=7ECD91F1EA0F7858005D5E7F6B3EDEC9D5579169DC9EF67BE6B36A6C5BE5885C)
        
    2.  确认当前子模块的 oh-package.json5 中，该模块已添加到 dependencies 依赖列表。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2c/v3/A9yDy0OqRF-Ye7UzXBrm-A/zh-cn_image_0000002298773813.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=DC2918D3A0F840CD975F92678D72BC36C1F253C57FAC2C8E2AC2197AECE86339)
        
    3.  若发现配置缺失，请手动补充完整。删除项目中的 oh\_modules 缓存目录，然后重新执行编译。
        
*   场景三：
    
    **问题现象**
    
    在HAP依赖字节码HAR进行编译的场景下，当import语句中的模块别名与dependencies中声明的别名大小写不一致时，编译系统将无法正确识别该依赖为字节码HAR，进而导致编译错误。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/10/v3/4M-d8mxyQLS8T0IbWdKcaQ/zh-cn_image_0000002264083960.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=7F0406A1BDD816FF2D74347BC82AF60C253BD748CABFAC27F07D47215DCFD410)
    
    **解决措施**
    
    请检查并确保所有import语句的模块别名与其在dependencies中的声明保持完全一致的大小写格式。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4a/v3/mH_sxwANTvOCl_kHRxWJGw/zh-cn_image_0000002298661041.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=7C2FD7527B8B6BD72FE5CBC402D5AC24BABDC96FE429D3DBBD59F053B2698D95)
    
*   场景四：
    
    **问题现象**
    
    在编译字节码HAR时，若将依赖配置于devDependencies下，hvigor构建系统在编译阶段不会收集devDependencies中的依赖项，导致依赖解析失败并引发编译错误。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d8/v3/Gn1MXWV-TF6Q3J0Wwq11WQ/zh-cn_image_0000002264141304.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=6E1A1FBAC146AA66B2A1C4E43A28FD0F3A756A29439DA88D5CCAACE9910532A7)
    
    **解决措施**
    
    请将依赖项从devDependencies移至dependencies。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ca/v3/yY4H4xXTQFaaIcGeLT_07g/zh-cn_image_0000002264084432.png?HW-CC-KV=V1&HW-CC-Date=20260612T074818Z&HW-CC-Expire=86400&HW-CC-Sign=38D0D82FDD14AD6ECCFA2E84BA483F8B674A8D00D7B0F5615213AB5ED19ECE96)