• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 数据共享错误码
2<!--Kit: ArkData-->
3<!--Subsystem: DistributedDataManager-->
4<!--Owner: @woodenarow-->
5<!--Designer: @woodenarow; @xuelei3-->
6<!--Tester: @chenwan188; @logic42-->
7<!--Adviser: @ge-yafang-->
8
9> **说明:**
10>
11> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。
12
13##  15700000 内部错误
14
15**错误信息**
16
17Inner error.
18
19**错误描述**
20
21内部错误。
22
23**可能原因**
24
25优先查看错误日志,通过日志可以详细了解错误原因,主要有以下几种:
261. 内部状态异常。
272. 错误地使用接口。
283. 权限配置错误。
294. 系统错误,如空指针、内存不足、数据服务异常重启、I/O错误、IPC异常、JS引擎异常等。
30
31**处理步骤**
32
331. 开发者排查是否存在对象关闭后再使用。
342. 开发者排查是否按接口文档正确使用接口。
353. 开发者排查权限配置是否正确。
364. 尝试重试,如果依然无法解决,可以提示用户重启应用、升级应用或升级设备版本。
37
38## 15700010 创建DataShareHelper异常
39
40**错误信息**
41
42The DataShareHelper fails to be initialized.
43
44**错误描述**
45
46创建DataShareHelper工具类异常时,系统会产生此错误码。
47
48**可能原因**
49
501. 创建DataShareHelper时,接口createDataHelper的入参uri不正确。
512. 创建DataShareHelper时,接口createDataHelper的入参context不正确。
523. 创建DataShareHelper时,客户端从后台拉起DataShareExtension时,未配置后台拉起权限。
53
54**处理步骤**
55
561. 咨询DataShare服务端提供者,获取正确的uri路径。
572. DataShare仅支持Stage模型,检查context是否为Stage模型的context。
583. 检查客户端是否有数据的读或者写权限,具体步骤如下:<br/>
59    (1) 找到数据提供者包名,在uri的path里面找,例如:uri = "datashareproxy://com.acts.ohos.data.datasharetest/test"。<br/>
60    (2) 根据包名找到配置,例如:bm dump --bundle-name com.acts.ohos.data.datasharetest,在里面找到DataShareExtension的配置,确认数据访问者是否有readPermission或writePermission中配置的权限。
61
62## 15700011 uri不存在
63
64**错误信息**
65
66The URI does not exist.
67
68**错误描述**
69
70添加/删除模板异常或者开启/关闭静默访问传入的uri格式或者路径错误时,系统会产生此错误码。
71
72**可能原因**
73
741. 入参uri路径不正确。
752. 入参uri格式不正确。
76
77**处理步骤**
78
79咨询DataShare服务端提供者,获取正确的uri路径。
80
81## 15700012 数据区不存在
82
83**错误信息**
84
85The data area does not exist.
86
87**错误描述**
88
89数据更新异常时,系统会产生此错误码。
90
91**可能原因**
92
93数据更新异常时,接口publish的入参bundleName不正确。
94
95**处理步骤**
96
97咨询DataShare服务端提供者,获取正确的bundleName。
98
99## 15700013 DataShareHelper实例被关闭
100
101**错误信息**
102
103The DataShareHelper instance is already closed.
104
105**错误描述**
106
107DataShareHelper实例被关闭后,继续使用该实例会产生此错误码。
108
109**可能原因**
110
111调用close接口关闭了DataShareHelper实例后,继续使用该实例。
112
113**处理步骤**
114
115重新创建DataShareHelper实例,再进行使用。
116
117## 15700014 配置共享参数错误
118
119**错误信息**
120
121The parameter format is incorrect or the value range is invalid.
122
123**错误描述**
124
1251. 参数格式错误。
126
1272. 参数值超出取值范围。
128
129**可能原因**
130
1311. URI长度超过256字节。
132
1332. proxyData的value长度超过4096字节。
134
1353. 接口传入的URI数组长度超过32。
136
1374. 接口传入的proxyData数组长度超过32。
138
1395. URI格式校验失败。
140
141**处理步骤**
142
1431. 检查接口传入的URI数组或者proxyData数组中是否有URI的长度超过256字节。
144
1452. 检查接口传入的proxyData数组中是否有proxyData的value长度超过4096字节。
146
1473. 检查接口传入的URI数组的长度是否超过32。
148
1494. 检查接口传入的proxyData数组的长度是否超过32。
150
1515. 检查接口传入的URI数组或者proxyData数组中的URI是否满足格式校验:<br/>
152    URI的固定格式为`"datashareproxy://{bundleName}/{path}"`,其中bundleName为配置发布方应用的bundleName,path可随意填写。