HarmonyOS 关系型数据库实验踩坑实录

今天在平台沙箱的云桌面上做了一次 HarmonyOS 关系型数据库实验。开发环境不在本地电脑上，而是在远程的云桌面里，本地只负责看实验手册、操作云桌面。实验本身的目标很明确：新建一个 HarmonyOS 工程，完成 Gradle 同步，然后接入关系型数据库，做建表和增删改查。流程听起来只有几步，但因为是第一次在沙箱云桌面里跑完整流程，中间踩了几个实打实的坑，记录下来，给同样要在云桌面里做实验的人参考。

一、实验环境和步骤

实验环境是平台提供的沙箱云桌面，开发工具已经预装在云桌面上，打开就能用。实验分两步：第一步是创建项目，按手册新建一个 HarmonyOS 工程；第二步是 Gradle 同步，等待依赖下载完成、工程同步通过，确认工程可以正常打开、没有报错，再继续往下写数据库相关的代码。前面这两步是后面所有操作的基础，同步没通过就没法往下走。

二、踩到的坑和处理办法

1. 新建 graphic 资源目录报错

按手册在 resources 目录下新建 graphic 目录时，操作直接报错，目录建不出来。处理办法是：先停下来检查目录层级和名称，确认自己没有选错父目录、没有输错名字；确认无误后退回重新创建一次，还是失败。这时不再反复尝试，而是先用已有的资源目录结构继续往下走，保证工程结构完整、后续步骤能继续，graphic 目录的问题放到后面再单独处理，不让一个目录卡住整个实验。

2. 代码粘贴不进远程桌面

手册里的示例代码想从本地浏览器复制、粘贴到云桌面里的编辑器，结果粘贴没有反应，代码进不去。处理办法是：放弃跨端复制粘贴，改为直接在云桌面内手打关键代码，短的片段逐行敲，长的分段敲，敲完对照手册逐行核对，确认没有敲错、没有漏行。

3. 远程剪贴板为空

打开远程剪贴板看了一眼，里面是空的，本地复制的内容根本没有传到云桌面。处理办法是：确认这条路走不通之后就不再反复尝试复制粘贴，改用手打；同时把手册页面和编辑器窗口并排摆放，照着手册敲，减少两个窗口之间来回切换的次数。

4. 部分手册代码在页面中被截断

手册页面里个别代码块显示不全，行尾被截断，看不到完整语句，直接照抄会缺东西。处理办法是：结合代码块前后的上下文和变量名，把被截断的部分补齐，再对照接口的常规用法核对一遍；凡是补不全、拿不准的地方先不写，先把能跑通的部分做起来，再回头处理不确定的代码，不让一段看不清的代码拖住整体进度。

5. 远程模拟器需要实名认证的华为开发者账号

做到需要用模拟器验证的环节时，远程模拟器提示需要登录已完成实名认证的华为开发者账号，没登录就用不了。处理办法是：用已完成实名认证的华为开发者账号登录模拟器；登录之前，先把不需要模拟器的部分做完，包括工程创建、Gradle 同步和数据库代码编写，避免在等待账号认证的环节里空等。

三、总结

这次实验最大的体会是：在沙箱云桌面里做实验，环境本身就是一半的工作量。本地复制粘贴、剪贴板这些平时想都不用想的功能，在远程桌面里都可能失效；手册代码被截断、资源目录建不出来这类小问题，单看都不大，但连在一起很耗时间。处理思路只有一条：先确认问题出在哪一层，是环境、是工具还是账号，再决定是绕过去还是停下来解决，不要在一条走不通的路上反复试。等模拟器账号就绪后，再继续做数据库增删改查的验证。