HarmonyOS鸿蒙Next中deleteToTrash(uri: string): Promise<string>接收使用约束是什么，我使用该接口删除应用沙箱中文件失败

这里的关键点是 deleteToTrash 面向的是“公共目录文件进系统回收站”，不是应用沙箱文件。你用它删除应用沙箱中的文件失败，方向上基本是符合预期的。FileManagerServiceKit 文档示例里的 URI 是公共目录形态，例如 Download 下的 file://docs/storage/Users/currentUser/Download/1.txt。

如果文件在应用沙箱，比如 filesDir/cacheDir 下，建议直接使用文件 API 删除，不走系统回收站：

import { fileIo as fs } from '@kit.CoreFileKit';

const path = getContext(this).filesDir + '/test.txt';
await fs.unlink(path);

如果确实要删除公共目录文件，则要确认三件事：URI 是公共目录 URI，不是沙箱 path；文件真实存在；当前应用已经获得对应文件的读写授权。

import { fileManagerService } from '@kit.FileManagerServiceKit';

const targetUri = 'file://docs/storage/Users/currentUser/Download/1.txt';
const trashUri = await fileManagerService.deleteToTrash(targetUri);
console.info('moved to trash: ' + trashUri);

所以排查时建议先打印 uri/path：沙箱路径用 fileIo 处理，公共目录 URI 才交给 fileManagerService.deleteToTrash，二者不要混用。

参考文档：

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/filemanagerservice-deletetotrash

https://developer.huawei.com/consumer/cn/doc/harmonyos-references/filemanagerservice-arkts-filemanagerservice#section439917413536

尊敬的开发者，您好，根据您提供的如上链接场景介绍已经明确说明：删除公共目录的文件到回收站。已表明fileManagerService.deleteToTrash接口中uri需要传参为待删除公共目录文件的uri。
您是想要此接口fileManagerService.deleteToTrash中uri参数说明为待删除公共目录文件的uri？麻烦您详细描述下您具体的诉求吧（例如：xxx链接需要添加xxx说明）

1014000001 操作不允许。当前用户文件操作不被允许，URI或path访问未授权。

处理步骤

1、通过系统文件选择器（FilePicker），选择用户文件从而获取URI临时权限。

2、通过程序访问控制机制，向用户申请授权从而获取目录权限。

解决：参考 文档类URI的使用方式 通过 DocumentViewPicker 接口选择或保存文件，返回选择或保存的文件URI。

import { fileManagerService } from '@kit.FileManagerServiceKit';
import { picker } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
@Entry
@Component
struct Index {

  build() {
    Column() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(async () => {
          let uris: string[] = [];
          // 请在组件内获取context，确保this.getUIContext().getHostContext()返回结果为UIAbilityContext
          let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
          // 创建文件选择器实例
          let documentSelectOptions = new picker.DocumentSelectOptions
          const documentViewPicker = new picker.DocumentViewPicker(context);
          documentViewPicker.select(documentSelectOptions).then(async (documentSelectResult: Array<string>) => {
            // 文件选择成功后，返回被选中文档的URI结果集。
            uris = documentSelectResult;
            let targetUri: string = uris.toString();
            try {
              let trashUri: string = await fileManagerService.deleteToTrash(targetUri);
              console.info(`trashUri: ` + trashUri);
            } catch (err) {
              let error: BusinessError = err as BusinessError;
              console.error(`delete failed, errCode:` + error.code + `, errMessage:` + error.message);
            }
            console.info(`documentViewPicker.select to file succeed and uris are:` + uris);
          }).catch((err: BusinessError) => {
            console.error(`Invoke documentViewPicker.select failed, code is ${err.code}, message is ${err.message}`);
          })
        })
    }
    .height('100%')
    .width('100%')
  }
}

这个问题看起来像是 deleteToTrash() 的使用场景理解错了，不太像权限问题。

先说结论：

fileManagerService.deleteToTrash() 主要针对用户文件（公共目录文件）设计，不支持直接删除应用沙箱里的文件。你传入的是应用沙箱 URI，所以返回 401 是正常现象。

你当前的流程：

let filePath = '/data/storage/el1/bundle/electron/resources/resfile/resources/app/my_file.txt'
let uri = fileUri.getUriFromPath(filePath)
await fileManagerService.deleteToTrash(uri)

生成出来的 URI 类似：

file://com.huawei.ohos_electron/data/storage/el1/bundle/...

这是典型的应用沙箱 URI。

为什么会报 401

deleteToTrash() 的本质不是：

删除文件

而是：

移动到系统回收站

而 HarmonyOS 的回收站机制是面向用户文件体系的。

例如：

Download
Documents
Desktop
Pictures

这些公共目录里的文件。

应用沙箱目录本身就不属于系统文件管理器管理的范围，因此：

沙箱文件
↓
没有回收站概念
↓
deleteToTrash失败

就会出现 401。

1014000001 又是什么

你前面提到：

Failed to delete the file to trash
code:1014000001

这个错误通常也说明：

当前 URI 不属于 deleteToTrash 支持的资源类型。

常见情况有：

• 沙箱文件
• 非 FilePicker 获取的 URI
• 自己拼出来的 URI
• 文件已经不存在

本质上还是 URI 来源不符合接口要求。

沙箱文件正确删除方式

对于：

/data/storage/el1/...

这种路径，

直接用：

import { fileIo as fs } from '@kit.CoreFileKit'
await fs.unlink(filePath)

或者：

fs.unlinkSync(filePath)

就行。

例如：

import { fileIo as fs } from '@kit.CoreFileKit'
try {
  await fs.unlink(filePath)
  console.info('删除成功')
} catch (err) {
  console.error(JSON.stringify(err))
}

还有一个细节

你的路径：

/data/storage/el1/bundle/electron/resources/resfile/resources/app/my_file.txt

我看到这里有点警觉。

因为：

resources
resfile

很多时候属于应用资源目录。

如果这个文件本来就是打包进 HAP 的资源文件，那么它本身就是只读的。

例如：

entry/src/main/resources/rawfile

打包后的资源文件。

这种文件：

能读
不能删
不能改

即使不用 deleteToTrash()，直接 unlink() 也会失败。

所以我觉得你应该先确认一下：

my_file.txt

到底是：

情况1

运行时创建的文件

filesDir
cacheDir
preferences目录

那就直接 unlink()。

情况2

工程资源文件

resources
rawfile
resfile

那它根本不允许删除。

从你贴出来的路径看：

/bundle/electron/resources/resfile/resources/app/

我反而更怀疑是第二种情况。这样的话别说 deleteToTrash()，任何删除接口都会失败。

应该是路径传入不对导致的；
一般通过DocumentViewPicker选择器来选择用户文件后再通过deleteToTrash去删除选择获取的路径地址uri
例如:file://docs/storage/Users/currentUser/Download/xxx.txt

沙箱文件获取的路径是 /data/storage/el2/base/xxx ,不符合当前api的 uri路径