1# 图数据库错误码 2 3> **说明：** 4> 5> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 6 7## 31300000 内部错误 8 9**错误信息** 10 11Inner error. 12 13**错误描述** 14 15内部错误。 16 17**可能原因** 18 19优先查看错误日志，通过日志可以详细了解错误原因，主要有以下几种： 201. gql执行异常。 212. 内部状态异常。 223. 错误地使用接口。 234. 系统错误，如空指针、数据服务异常重启、I/O错误、JS引擎异常等。 24 25**处理步骤** 26 271. 开发者排查是否按接口文档正确使用接口。 282. 尝试重试，如果依然无法解决，可以提示用户重启应用、升级应用或升级设备版本。 29 30## 31300001 数据库文件损坏 31 32**错误信息** 33 34Database corrupted. 35 36**错误描述** 37 38该错误码表示在调用数据库read、write等接口时，数据库已损坏。 39 40**可能原因** 41 42调用数据库read、write等接口操作数据库时，数据库文件已损坏。 43 44**处理步骤** 45 46目前暂不支持图数据库的备份、恢复，如果可以接受数据库数据丢失，则可尝试删除数据库后重新创建。 47 48## 31300002 数据库或事务关闭 49 50**错误信息** 51 52Already closed. 53 54**错误描述** 55 56数据库或事务关闭。 57 58**可能原因** 59 601. 执行当前操作时，已调用过[close](js-apis-data-graphStore-sys.md#close)接口关闭图数据库或者开库未成功。 612. 执行当前操作时，已调用过[commit](js-apis-data-graphStore-sys.md#commit)接口提交事务或者调用过[rollback](js-apis-data-graphStore-sys.md#rollback)接口回滚事务。 62 63**处理步骤** 64 651. 使用[getStore](js-apis-data-graphStore-sys.md#graphstoregetstore)接口重新开库，注意入参应与前一次成功开库时的入参保持一致。 662. 使用[createTransaction](js-apis-data-graphStore-sys.md#createtransaction)接口重新创建事务。 67 68## 31300003 数据库BUSY 69 70**错误信息** 71 72The database is busy. 73 74**错误描述** 75 76数据库BUSY。 77 78**可能原因** 79 801. 同一应用多个进程同时打开了同一个数据库，进行读写操作。 812. 进程内多线程同时进行读写操作，导致某一线程读写操作超时。 823. 存在一个事务调用过[write](js-apis-data-graphStore-sys.md#write)接口写入数据但未提交或回滚。 83 84**处理步骤** 85 861. 避免进程并发操作数据库。 872. 等待一段时间重试。 883. 提交或回滚未关闭的事务。 89 90## 31300004 数据库内存不足 91 92**错误信息** 93 94The database is out of memory. 95 96**错误描述** 97 98数据库内存不足。 99 100**可能原因** 101 102数据库内存不足，可能是由于数据量过大或内存分配不足导致的。 103 104**处理步骤** 105 106减小数据量或尝试通过清理其他进程增加内存分配。 107 108## 31300005 数据库已满 109 110**错误信息** 111 112The database is full. 113 114**错误描述** 115 116数据库已满。 117 118**可能原因** 119 120数据库已满，可能是由于当前db数据量已达上限或磁盘空间不足导致的。 121 122**处理步骤** 123 124使用[GraphStore.write](js-apis-data-graphStore-sys.md#write-1)或[Transaction.write](js-apis-data-graphStore-sys.md#write)接口删除同系列数据后再插入。 125 126## 31300006 存在重复的图名、顶点的类型或属性、边的类型或属性 127 128**错误信息** 129 130A duplicate graph name, vertex or edge type, or vertex or edge property name exists. 131 132**错误描述** 133 134存在重复的图名、顶点的类型或属性、边的类型或属性。 135 136**可能原因** 137 1381. 数据库内已存在同名的图。 1392. 不同顶点使用了相同的类型或属性。 1403. 不同边使用了相同的类型或属性。 141 142**处理步骤** 143 144使用[GraphStore.write](js-apis-data-graphStore-sys.md#write-1)或[Transaction.write](js-apis-data-graphStore-sys.md#write)接口创建图时，检查建图语句中图名、顶点的类型（[Vertex.labels](js-apis-data-graphStore-sys.md#vertex)）或属性（[Vertex.properties](js-apis-data-graphStore-sys.md#vertex)）以及边的类型（[Edge.type](js-apis-data-graphStore-sys.md#edge)）或属性（[Edge.labels](js-apis-data-graphStore-sys.md#edge)）是否存在上述冲突。 145 146## 31300007 未定义图名、顶点和边的类型或属性 147 148**错误信息** 149 150The graph name, vertex or edge type, or vertex or edge property is not defined. 151 152**错误描述** 153 154未定义图名、顶点和边的类型或属性。 155 156**可能原因** 157 158存在图名、顶点和边的类型或属性未被定义。 159 160**处理步骤** 161 162使用[GraphStore.write](js-apis-data-graphStore-sys.md#write-1)或[Transaction.write](js-apis-data-graphStore-sys.md#write)接口创建图或插入顶点和边时，检查本次创建图的图名或插入的顶点的类型（[Vertex.labels](js-apis-data-graphStore-sys.md#vertex)）或属性（[Vertex.properties](js-apis-data-graphStore-sys.md#vertex)）以及边的类型（[Edge.type](js-apis-data-graphStore-sys.md#edge)）或属性（[Edge.labels](js-apis-data-graphStore-sys.md#edge)）是否在创建图时已定义。 163 164## 31300008 图名、顶点和边的类型或属性不符合约束 165 166**错误信息** 167 168The graph name, vertex or edge type, or vertex or edge property name does not conform to constraints. 169 170**错误描述** 171 172图名、顶点和边的类型或属性不符合约束。 173 174**可能原因** 175 1761. 图名长度超过上限（128字节）。 1772. 主键冲突。 1783. 唯一索引冲突。 179 180**处理步骤** 181 182使用[GraphStore.write](js-apis-data-graphStore-sys.md#write-1)或[Transaction.write](js-apis-data-graphStore-sys.md#write)接口创建图时，检查建图语句中图名、顶点的类型（[Vertex.labels](js-apis-data-graphStore-sys.md#vertex)）或属性（[Vertex.properties](js-apis-data-graphStore-sys.md#vertex)）以及边的类型（[Edge.type](js-apis-data-graphStore-sys.md#edge)）或属性（[Edge.labels](js-apis-data-graphStore-sys.md#edge)）是否符合上述约束。 183 184## 31300009 GQL语句语法错误 185 186**错误信息** 187 188The GQL statement syntax error. 189 190**错误描述** 191 192GQL语句语法错误。 193 194**可能原因** 195 196GQL语句语法错误。 197 198**处理步骤** 199 200参照行业标准，检查修改确保GQL语句语法正确。 201 202## 31300010 GQL语句语义错误 203 204**错误信息** 205 206The GQL statement semantic error. 207 208**错误描述** 209 210GQL语句语义错误。 211 212**可能原因** 213 214GQL语句语义错误。 215 216**处理步骤** 217 218参照行业标准，检查修改确保GQL语句语义正确。 219 220## 31300012 图、顶点和边的类型或属性数量超过了上限 221 222**错误信息** 223 224The number of graph names, vertex or edge types, or vertex or edge properties exceeds the limit. 225 226**错误描述** 227 228图、顶点和边的类型或属性数量超过了上限。 229 230**可能原因** 231 232图、顶点和边的类型或属性数量超过了上限。 233 234**处理步骤** 235 236减少顶点和边的类型或属性数量。同一个数据库内，仅可创建一个图，顶点和边的属性上限均为1024个。 237 238## 31300013 冲突约束已存在 239 240**错误信息** 241 242A conflicting constraint already exists. 243 244**错误描述** 245 246冲突约束已存在。 247 248**可能原因** 249 250主键冲突、唯一索引冲突或其他语法约束冲突。 251 252**处理步骤** 253 254参照行业标准，检查修改确保GQL语句无上述冲突存在。 255 256## 31300014 数据库路径不合法 257 258**错误信息** 259 260Invalid database path. 261 262**错误描述** 263 264数据库路径不合法。 265 266**可能原因** 267 268数据库路径没有权限访问。 269 270**处理步骤** 271 272图数据库暂不支持自定义路径，目前仅支持使用[Context](../apis-ability-kit/js-apis-inner-app-context.md)中默认沙箱路径。请参考[getStore](js-apis-data-graphStore-sys.md#graphstoregetstore)接口示例代码进行修正。 273 274## 31300015 关键配置已被更改 275 276**错误信息** 277 278Config changed. 279 280**错误描述** 281 282数据库关键配置已被更改。 283 284**可能原因** 285 286数据库的name（名称），securityLevel（安全级别），encrypt（是否加密）等关键配置发生变化。 287 288**处理步骤** 289 290保持原配置不变或者用原配置导出数据，删除旧库，用新配置创建新库，数据存入新库。支持安全级别从低到高变更。