1# 文件管理错误码
2
3> **说明:**
4>
5> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。
6
7文件管理子系统错误码由五部分组成,分别是[基础文件IO错误码](#基础文件io错误码)、[用户数据管理错误码](#用户数据管理错误码)、[公共文件访问错误码](#公共文件访问错误码)、[空间统计错误码](#空间统计错误码)和[端云同步错误码](#端云同步错误码)。
8
9## 基础文件IO错误码
10
11### 13900001 操作不允许
12
13**错误信息**
14
15Operation not permitted
16
17**可能原因**
18
19当前用户文件操作不被允许,URI或path访问未授权。
20
21**处理步骤**
22
231、根据当前系统的[访问控制机制](../../security/AccessToken/access-token-overview.md),应用无法使用分享给其他应用的URI。
24
252、根据[系统Picker](../../application-models/system-app-startup.md)的运行机制,通过Picker获取到的URI仅有临时权限,无法持久化保存使用。
26
273、URI路径不推荐进行拼接,拼接后的URI默认未授权。
28
29### 13900002 没有这个文件或目录
30
31**错误信息**
32
33No such file or directory
34
35**可能原因**
36
37文件或目录不存在。
38
39**处理步骤**
40
41确认文件路径是否存在。
42
43### 13900003 没有这样的进程
44
45**错误信息**
46
47No such process
48
49**可能原因**
50
51进程不存在。
52
53**处理步骤**
54
551.确认进程是否被意外杀死。
56
572.确认相关服务是否已启动。
58
59### 13900004 系统调用被中断
60
61**错误信息**
62
63Interrupted system call
64
65**可能原因**
66
67系统调用被其他线程中断。
68
69**处理步骤**
70
711.检查多线程代码逻辑。
72
732.重新进行系统调用。
74
75### 13900005 I/O错误
76
77**错误信息**
78
79I/O error
80
81**可能原因**
82
83IO请求非法。
84
85**处理步骤**
86
87重新进行IO请求。
88
89### 13900006 没有这个设备或地址
90
91**错误信息**
92
93No such device or address
94
95**可能原因**
96
97设备或地址信息错误。
98
99**处理步骤**
100
101确认设备或地址信息。
102
103### 13900007 参数列表太长
104
105**错误信息**
106
107Arg list too long
108
109**可能原因**
110
111参数列表过长。
112
113**处理步骤**
114
115减少参数个数。
116
117### 13900008 坏的文件描述符
118
119**错误信息**
120
121Bad file descriptor
122
123**可能原因**
124
1251. 此文件描述符已关闭。
1262. 读写权限不匹配。
127
128**处理步骤**
129
1301. 确认此文件描述符是否已关闭。
1312. 确认此文件读写权限是否匹配
132
133### 13900009 没有子进程
134
135**错误信息**
136
137No child processes
138
139**可能原因**
140
141无法创建子进程。
142
143**处理步骤**
144
145确认系统中最大进程数。
146
147### 13900010 资源暂时不可用
148
149**错误信息**
150
151Try again
152
153**可能原因**
154
155资源被阻塞。
156
157**处理步骤**
158
159重新请求资源。
160
161### 13900011 内存溢出
162
163**错误信息**
164
165Out of memory
166
167**可能原因**
168
169内存溢出。
170
171**处理步骤**
172
1731.确认内存开销。
174
1752.管理系统内存开销。
176
177### 13900012 拒绝许可
178
179**错误信息**
180
181Permission denied
182
183**可能原因**
184
1851.文件操作被DAC或selinux拦截。
186
1872.文件沙箱路径地址错误。
188
189**处理步骤**
190
1911.访问被DAC自主式权限控制权限拦截,请排查文件的UGO权限。
192
1932.排查内核日志中是否有[avc拦截日志](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-security-selinux-develop-intro.md),如果存在avc拦截告警,<!--RP1-->拦截原因分析请参考[SELinux开发说明](../../../device-dev/subsystems/subsys-security-selinux-develop-intro.md)。<!--RP1End-->
194
1953.确认文件的路径是否为应用内的沙箱路径[沙箱路径地址](../../file-management/app-sandbox-directory.md),文件管理系统禁止操作应用沙箱以外的文档。
196
197### 13900013 错误的地址
198
199**错误信息**
200
201Bad address
202
203**可能原因**
204
205地址错误。
206
207**处理步骤**
208
209确认地址是否正确。
210
211### 13900014 设备或资源忙
212
213**错误信息**
214
215Device or resource busy
216
217**可能原因**
218
219请求的资源不可用。
220
221**处理步骤**
222
223重新请求资源。
224
225### 13900015 文件存在
226
227**错误信息**
228
229File exists
230
231**可能原因**
232
233需创建的文件已存在。
234
235**处理步骤**
236
237确认文件路径是否正确。
238
239### 13900016 无效的交叉链接
240
241**错误信息**
242
243Cross-device link
244
245**可能原因**
246
247跨设备链接失败。
248
249**处理步骤**
250
251确认跨设备是否正常。
252
253### 13900017 设备不存在
254
255**错误信息**
256
257No such device
258
259**可能原因**
260
261设备未被识别。
262
263**处理步骤**
264
265确认设备间连接是否正常。
266
267### 13900018 不是一个目录
268
269**错误信息**
270
271Not a directory
272
273**可能原因**
274
275此路径不是文件夹目录。
276
277**处理步骤**
278
279确认路径是否正确。
280
281### 13900019 是一个目录
282
283**错误信息**
284
285Is a directory
286
287**可能原因**
288
289此路径是文件夹目录。
290
291**处理步骤**
292
293确认路径是否正确。
294
295### 13900020 无效的参数
296
297**错误信息**
298
299Invalid argument
300
301**可能原因**
302
303输入参数非法。
304
305**处理步骤**
306
307确认参数合法性。
308
309### 13900021 打开太多的文件系统
310
311**错误信息**
312
313File table overflow
314
315**可能原因**
316
317进程打开过多的文件描述符。
318
319**处理步骤**
320
321关闭不相关的文件描述符。
322
323### 13900022 打开的文件过多
324
325**错误信息**
326
327Too many open files
328
329**可能原因**
330
331系统打开过多的文件。
332
333**处理步骤**
334
335关闭不需要的文件。
336
337### 13900023 文本文件忙
338
339**错误信息**
340
341Text file busy
342
343**可能原因**
344
345程序的可执行文件正在被使用。
346
347**处理步骤**
348
349关闭正在调试的程序。
350
351### 13900024 文件太大
352
353**错误信息**
354
355File too large
356
357**可能原因**
358
359文件大小超出最大文件大小。
360
361**处理步骤**
362
363确认文件大小是否满足最大文件大小。
364
365### 13900025 设备上没有空间
366
367**错误信息**
368
369No space left on device
370
371**可能原因**
372
373设备存储空间不足。
374
375**处理步骤**
376
377清理设备存储空间。
378
379### 13900026 非法移位
380
381**错误信息**
382
383Illegal seek
384
385**可能原因**
386
387在管道或FIFO中使用seek。
388
389**处理步骤**
390
391确认seek使用。
392
393### 13900027 只读文件系统
394
395**错误信息**
396
397Read-only file system
398
399**可能原因**
400
401文件系统只支持读。
402
403**处理步骤**
404
405确认文件是否只读。
406
407### 13900028 太多的链接
408
409**错误信息**
410
411Too many links
412
413**可能原因**
414
415文件已达最大链接数。
416
417**处理步骤**
418
419清理无用链接。
420
421### 13900029 资源死锁错误
422
423**错误信息**
424
425Resource deadlock would occur
426
427**可能原因**
428
429资源死锁。
430
431**处理步骤**
432
433终止死锁进程。
434
435### 13900030 文件名太长
436
437**错误信息**
438
439Filename too Long
440
441**可能原因**
442
443文件名超过最大长度255字节。
444
445**处理步骤**
446
447确认文件名长度。
448
449### 13900031 功能没有实现
450
451**错误信息**
452
453Function not implemented
454
455**可能原因**
456
457系统不支持此功能。
458
459**处理步骤**
460
461确认系统版本。
462
463### 13900032 目录非空
464
465**错误信息**
466
467Directory not empty
468
469**可能原因**
470
471指定目录不为空。
472
473**处理步骤**
474
4751.确认目录路径。
476
4772.确认路径为空。
478
479### 13900033 符号链接层次太多
480
481**错误信息**
482
483Too many symbolic links encountered
484
485**可能原因**
486
487符号链接层次过多。
488
489**处理步骤**
490
491清理无关符号链接。
492
493### 13900034 操作被阻塞
494
495**错误信息**
496
497Operation would block
498
499**可能原因**
500
501操作被阻塞。
502
503**处理步骤**
504
505重新进行操作。
506
507### 13900035 请求描述符无效
508
509**错误信息**
510
511Invalid request descriptor
512
513**可能原因**
514
515文件描述符非法。
516
517**处理步骤**
518
519确认文件描述符是否合法。
520
521### 13900036 设备不是字符流
522
523**错误信息**
524
525Device not a stream
526
527**可能原因**
528
529文件描述符指向非流设备。
530
531**处理步骤**
532
533确认文件描述符是否指向流设备。
534
535### 13900037 无可用数据
536
537**错误信息**
538
539No data available
540
541**可能原因**
542
543数据不可用。
544
545**处理步骤**
546
547重新请求数据。
548
549### 13900038 对于定义的数据类型,值太大
550
551**错误信息**
552
553Value too large for defined data type
554
555**可能原因**
556
557值超出所定义的数据类型范围。
558
559**处理步骤**
560
561修改数据类型。
562
563### 13900039 文件描述符在坏状态
564
565**错误信息**
566
567File descriptor in bad state
568
569**可能原因**
570
571文件描述符损坏。
572
573**处理步骤**
574
575确认文件描述符合法性。
576
577### 13900040 应该重新启动被中断的系统调用
578
579**错误信息**
580
581Interrupted system call should be restarted
582
583**可能原因**
584
585系统调用被中断。
586
587**处理步骤**
588
589重新进行系统调用。
590
591### 13900041 超出磁盘配额
592
593**错误信息**
594
595Quota exceeded
596
597**可能原因**
598
599磁盘空间不足。
600
601**处理步骤**
602
603清理磁盘存储空间。
604
605### 13900042 未知错误
606
607**错误信息**
608
609Unknown error
610
611**可能原因**
612
613内部错误。
614
615**处理步骤**
616
6171.重试接口。
618
6192.重启服务。
620
621### 13900043 没有可用的锁
622
623**错误信息**
624
625No record is locks available
626
627**可能原因**
628
629系统资源不足。
630
631**处理步骤**
632
633释放锁资源后重试
634
635### 13900044 网络无法访问
636
637**错误信息**
638
639Network is unreachable
640
641**可能原因**
642
643网络异常。
644
645**处理步骤**
646
647检查网络状态,确认状态正常。
648
649### 13900045 连接失败
650
651**错误信息**
652
653Connection failed
654
655**可能原因**
656
657设备、Wifi或蓝牙状态异常,导致建立链接失败。
658
659**处理步骤**
660
6611. 检查设备,确认设备状态正常。
662
6632. 检查WiFi和蓝牙,确认状态正常。
664
665### 13900046 软件造成连接中断
666
667**错误信息**
668
669Software caused connection abort
670
671**可能原因**
672
673设备下线或WiFi、蓝牙断连。
674
675**处理步骤**
676
6771. 检查设备,确认设备状态正常。
678
6792. 检查WiFi和蓝牙,确认状态正常。
680
681## 用户数据管理错误码
682
683### 14000001 文件名非法
684
685**错误信息**
686
687Invalid file name
688
689**可能原因**
690
691文件名存在非法字符。
692
693**处理步骤**
694
695删除非法字符。
696
697### 14000002 非法URI
698
699**错误信息**
700
701Invalid URI
702
703**可能原因**
704
705URI不合法。
706
707**处理步骤**
708
709直接使用查询获取的uri。
710
711### 14000003 文件后缀非法
712
713**错误信息**
714
715Invalid file name extension
716
717**可能原因**
718
719按照文件类型命名。
720
721**处理步骤**
722
723检查文件名后缀。
724
725### 14000004 文件已进入回收站
726
727**错误信息**
728
729File already in the recycle bin
730
731**可能原因**
732
733文件已经被删除进入回收站。
734
735**处理步骤**
736
737检查文件是否已经进入回收站。
738
739### 14000011 系统内部错误
740
741**错误信息**
742
743System inner fail
744
745**可能原因**
746
747系统异常,发生未知错误。
748
749**处理步骤**
750
751清理后台,或重启设备。
752
753### 14000014 成员名非法
754
755**错误信息**
756
757Member is not a valid PhotoKey
758
759**可能原因**
760
761传入的字符串不是类或接口的成员名。
762
763**处理步骤**
764
765确保传入的字符串为类或接口的成员名。
766
767## 空间统计错误码
768
769### 13600001 IPC通信失败
770
771**错误信息**
772
773IPC error
774
775**可能原因**
776
777调用服务不存在。
778
779**处理步骤**
780
781检查服务是否启动。
782
783### 13600002 文件系统类型不支持
784
785**错误信息**
786
787File system not supported
788
789**可能原因**
790
791操作的文件系统类型不支持。
792
793**处理步骤**
794
795修改为正确的文件系统类型。
796
797### 13600003 挂载失败
798
799**错误信息**
800
801Mount failed
802
803**可能原因**
804
805调用挂载命令失败。
806
807**处理步骤**
808
809拔卡尝试重新挂载。
810
811### 13600004 卸载失败
812
813**错误信息**
814
815Unmount failed
816
817**可能原因**
818
819设备繁忙。
820
821**处理步骤**
822
823检查外卡文件是否被线程占用, 杀掉占用线程。
824
825### 13600005 卷状态错误
826
827**错误信息**
828
829Incorrect volume state
830
831**可能原因**
832
833操作的卷状态错误。
834
835**处理步骤**
836
837检查当前卷状态是否正确。
838
839### 13600006 创建目录或者节点失败
840
841**错误信息**
842
843Failed to create the drectory or node
844
845**可能原因**
846
847目录或节点已存在。
848
849**处理步骤**
850
851检查待创建目录或节点是否存在。
852
853### 13600007 删除目录或者节点失败
854
855**错误信息**
856
857Failed to delete the drectory or node
858
859**可能原因**
860
861目录或节点已删除。
862
863**处理步骤**
864
865检查待删除目录或节点是否存在。
866
867### 13600008 操作对象不存在
868
869**错误信息**
870
871No such object
872
873**可能原因**
874
8751.输入错误的卷id。
876
8772.输入错误的包名。
878
879**处理步骤**
880
8811.检查输入的卷是否存在。
882
8832.检查输入的应用包名是否存在。
884
885### 13600009 用户id超出范围
886
887**错误信息**
888
889User ID out of range
890
891**可能原因**
892
893输入错误的用户id。
894
895**处理步骤**
896
897检查输入的用户id是否处于正常范围。
898
899## 公共文件访问错误码
900
901### 14300001 IPC通信失败
902
903**错误信息**
904
905IPC error
906
907**可能原因**
908
9091.server端服务不在。
910
9112.extension机制异常。
912
913**处理步骤**
914
915检查server端服务是否存在。
916
917### 14300002 URI格式错误
918
919**错误信息**
920
921Invalid URI
922
923**可能原因**
924
925使用非法uri。
926
927**处理步骤**
928
929检查URI格式。
930
931### 14300003 查询server端ability信息失败
932
933**错误信息**
934
935Failed to obtain the server ability information
936
937**可能原因**
938
939BMS接口异常。
940
941**处理步骤**
942
943系统基础能力问题
944
945### 14300004 js-server实际返回的结果异常
946
947**错误信息**
948
949Incorrect result returned by js-server
950
951**可能原因**
952
953server端返回实际数据不当。
954
955**处理步骤**
956
957server端返回值检查。
958
959### 14300005 notify注册失败
960
961**错误信息**
962
963Failed to register Notify
964
965**可能原因**
966
9671.server端服务不在。
968
9692.extension机制异常。
970
971**处理步骤**
972
973检查server端服务是否存在。
974
975### 14300006 notify移除失败
976
977**错误信息**
978
979Failed to unregister Notify
980
981**可能原因**
982
9831.server端服务不在。
984
9852.extension机制异常。
986
987**处理步骤**
988
989检查server端服务是否存在。
990
991### 14300007 notify代理初始化失败
992
993**错误信息**
994
995Failed to initialize the Notify agent
996
997**可能原因**
998
999未注册就去取消notify。
1000
1001**处理步骤**
1002
1003是否注册过。
1004
1005### 14300008 js-server端通知代理失败
1006
1007**错误信息**
1008
1009Failed to notify the agent
1010
1011**可能原因**
1012
10131.服务不在。
1014
10152.extension机制异常。
1016
1017**处理步骤**
1018
1019检查client是否异常。
1020
1021## 端云同步错误码
1022
1023### 22400001 云端状态未ready
1024
1025**错误信息**
1026
1027Cloud status not ready
1028
1029**可能原因**
1030
10311.未启用云。
1032
10332.应用云同步开关未打开。
1034
1035**处理步骤**
1036
10371.检查是否账号登录。
1038
10392.检查云同步开关是否打开。
1040
1041### 22400002  网络不可用
1042
1043**错误信息**
1044
1045Network unavailable
1046
1047**可能原因**
1048
1049设备未联网或网络不可用。
1050
1051**处理步骤**
1052
1053检查网络状态。
1054
1055### 22400003  告警电量
1056
1057**错误信息**
1058
1059Low battery level
1060
1061**可能原因**
1062
1063电量过低。
1064
1065**处理步骤**
1066
1067充电状态或电量恢复后再执行。
1068