模拟器创建和启动失败的原因有哪些
================

#### 问题现象

在创建或启动模拟器时失败，失败的原因有哪些，如何解决？

#### 背景知识

*   创建模拟器的步骤可参考[创建模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-create)。
*   常见模拟器错误码参考：[模拟器错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs)。

#### 问题定位

*   创建或启动模拟器时失败，可能有多种现象和原因，汇总如下：
    
    | 
    问题场景
    
     | 
    
    问题原因
    
     |
    | :-- | :-- |
    | 
    
    模拟器因中文路径问题导致启动崩溃。
    
     | 
    
    AppData路径中带有中文名称。
    
     |
    | 
    
    API14版本模拟器在RTX 3060系列上启动崩溃。
    
     | 
    
    系统问题。
    
     |
    | 
    
    电脑内存不足导致模拟器启动失败。
    
     | 
    
    内存不足。
    
     |
    | 
    
    电脑GPU版本过低导致模拟器启动失败。
    
     | 
    
    GPU版本过低。
    
     |
    | 
    
    Windows句柄占用过多导致模拟器启动崩溃。
    
     | 
    
    Windows句柄占用过多。
    
     |
    | 
    
    Mac x86 PC模拟器启动黑屏或提示：模拟器不支持Mac x86 PC。
    
     | 
    
    新版本模拟器已不再支持对x86架构Mac电脑的支持。
    
     |
    | 
    
    当前CPU不支持AES指令导致模拟器启动失败。
    
     | 
    
    CPU不支持AES指令。
    
     |
    | 
    
    使用命令行启动模拟器失败。
    
     | 
    
    当前DevEco Studio版本不支持命令行拉起模拟器。
    
     |
    | 
    
    SDK路径变化导致模拟器启动失败。
    
     | 
    
    SDK路径变化。
    
     |
    
*   **场景一**：模拟器因中文路径问题导致启动崩溃。
    *   现象：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/47/v3/o2mGcgUxSjizsv_eyAmB2g/zh-cn_image_0000002628569678.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=F24D1579B53707B32DC73465B19D526E2C66B3A184FF822E659016AECADEEF38 "点击放大")
        
    *   定位：点击上图报错弹窗的发送报告按钮，将报错日志下载到本地进行分析。如果日志中出现如下报错，是因为AppData路径中带有中文名称，导致模拟器某些文件无法找到，最终导致模拟器启动失败。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/36/v3/p1RDx-47S023tJR7EFveUw/zh-cn_image_0000002658928991.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=EAFCB66CE7B3AB2E8AD31773ADB14A0C622046789631AAFA6561C535BFF90206 "点击放大")
        
*   **场景二**：API14版本模拟器在RTX 3060系列上启动崩溃。
    
    定位：排查IDE版本是否是API14的DevEco Studio 5.0.2 Release（5.0.7.210）版本，并且排查用户的GPU是否是RTX 3060系列，因系统问题该版本在RTX 3060系列上运行会导致模拟器崩溃。
    
*   **场景三**：电脑内存不足导致模拟器启动失败。
    *   现象：启动报错弹窗提示“当前系统可申请的内存不足XXGB”。
    *   定位：通过报错弹窗信息或在日志中搜索memory is low，如果有如下对应日志，说明是电脑内存不足导致模拟器闪退：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/71/v3/1KWTFkrGSQCm-sCgmuUeQg/zh-cn_image_0000002628409778.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=2FF1A05C6D1E62597585FC3FADCB0839ED19B66479F556AB47775295B372C1A8 "点击放大")
        
*   **场景四**：电脑GPU版本过低导致模拟器启动失败。
    *   现象：启动模拟器失败报错：The graphics card in use does not support OpenGL 4.1 or later. Update the graphics card driver or use another graphics card.
    *   定位：当前显卡驱动版本过低，或不支持OpenGL4.1或以上版本。参考：[00801013 显卡驱动版本过低](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs#section73144516710)。
*   **场景五**：Windows句柄占用过多导致模拟器启动崩溃。
    
    定位：如果有如下对应日志，说明是Windows句柄占用过多导致模拟器启动崩溃。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/60/v3/FnjwFO6ORUafky6vUJwTpQ/zh-cn_image_0000002658809045.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=63A4C95BBB5A0968C81BE1F0CC93973F79E68DBD589DAFE7DAF538C99FE45EE6 "点击放大")
    
*   **场景六**：Mac x86 PC模拟器启动黑屏或提示：模拟器不支持Mac x86 PC。
    *   现象：Mac x86 PC模拟器启动黑屏，如下图所示：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3c/v3/eXwDJ4_tT7GTNueroPl0Sg/zh-cn_image_0000002628569680.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=45818468482565F0CF7E839A2CB633CD9786B85BD90C2BF2343C8A9F71EA1F9E "点击放大")
        
        或者在创建模拟器时提示：The local emulator does not support Mac x86 PCs. Please use the emulator on Mac ARM and Windows PCs，如下图所示：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/11/v3/tnSOP4DDSO65FNsIFBtL7A/zh-cn_image_0000002658928993.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=3842DB1A58446C62370D70ECA9AC7C27E4319FE79E837C724C299A6AD47FD19F "点击放大")
        
    *   定位：参考[设备支持类型](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-devicetype)，明确指出模拟器支持系统类型为Windows(X86)和macOS(ARM)，HarmonyOS新版本模拟器已不再支持对x86架构Mac电脑的支持，无法直接创建新模拟器。
*   **场景七**：当前CPU不支持AES指令导致模拟器启动失败。
    *   现象：启动报错弹窗提示“模拟器启动失败，当前CPU不支持AES指令”。
    *   定位：参考[00801004 CPU不支持AES指令](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs#section29911463342)可知，当前CPU不支持AES指令。
*   **场景八**：使用命令行启动模拟器失败。
    *   现象：使用命令行方式启动模拟器报错：模拟器启动失败。请在DevEco Studio中登录华为账号，并从设备管理中启动模拟器。
    *   定位：根据[启动模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-command-line#section11776121917710)章节的说明可知，该版本的模拟器无法通过命令行启动。
*   **场景九**：SDK路径变化导致模拟器启动失败。
    *   现象：启动模拟器失败，提示“SDK Path has been changed to xxx”，如下图：
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4d/v3/K34qjHNUSIaRHfhYnGpaTw/zh-cn_image_0000002628409780.png?HW-CC-KV=V1&HW-CC-Date=20260709T134426Z&HW-CC-Expire=86400&HW-CC-Sign=868E62BCDFC86150B1D2A70E811C46F3DD02BE98F7D0478F754EBD0B67AA9553 "点击放大")
        
    *   定位：参考[00801014 SDK路径更改](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs#section19375152318218)可知，SDK路径更改导致模拟器启动失败。

#### 分析结论

*   **场景一**：AppData路径中带有中文名称会导致模拟器拉起失败。
*   **场景二**：因系统问题API14版本运行在RTX 3060系列上会导致模拟器闪退。
*   **场景三**：内存不足导致模拟器失败。
*   **场景四**：GPU版本过低会导致模拟器闪退。
*   **场景五**：Windows句柄占用过多会导致模拟器崩溃。
*   **场景六**：HarmonyOS新版本模拟器已不再支持对x86架构Mac电脑的支持。
*   **场景七**：当前CPU不支持AES指令导致模拟器启动失败。
*   **场景八**：当前DevEco Studio版本不支持命令行拉起模拟器。
*   **场景九**：SDK路径更改导致模拟器启动失败。

#### 修改建议

*   **场景一**：把AppData路径修改为英文路径。
*   **场景二**：DevEco Studio升级到最新的Release版本，下载地址：[最新版本](https://developer.huawei.com/consumer/cn/download/)。
*   **场景三**：清理电脑运行内存并重启IDE。或参考：[00801005 可申请内存不足](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs#section4348205417203)中的处理步骤。
*   **场景四**：升级显卡驱动，如果原显卡不支持OpenGL则需要更换显卡，具体要求请参考[使用环境](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-requirements)。
*   **场景五**：将DevEco Studio升级到5.1.0 Release版本及以上，模拟器版本更新到API18及以上即可解决。
*   **场景六**：
    *   **方案一**：使用Windows(X86)版本或macOS(ARM)版本电脑进行开发。
    *   **方案二**：使用[云调试](https://developer.huawei.com/consumer/cn/agconnect/cloud-adjust/)进行开发调试。
*   **场景七**：使用真机调试或[云调试](https://developer.huawei.com/consumer/cn/agconnect/cloud-adjust/)进行开发调试。
*   **场景八**：DevEco Studio升级到最新的Release版本，下载地址：[最新版本](https://developer.huawei.com/consumer/cn/download/)。
*   **场景九**：参考[00801014 SDK路径更改](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs#section19375152318218)章节的处理步骤如下。
    1.  在Local Emulator的设备列表窗口，点击“Wipe User Data”清除模拟器数据，然后重新启动模拟器。
    2.  重新创建一个模拟器，然后启动新建的模拟器。

#### 常见FAQ

Q：模拟器运行闪退是否可以提供具体的错误码提示及修复手段？

A：目前DevEco Studio 6.0.0.858版本基本已经支持错误码提示或弹窗提示说明具体原因及处理步骤，具体错误码参考[模拟器错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-faqs)。