iOS平台Cordova FileTransfer下载报错：Could not create target file（错误码1）

我明白你在iOS上用FileTransfer下载特定PDF时碰到的这个棘手问题——明明同大小的其他文件能正常下载，偏偏某些PDF就报创建目标文件失败的错。我来帮你梳理下可能的原因和对应的解决办法：

可能的问题根源 #

• 文件名暗藏坑点：iOS对文件路径里的特殊字符（比如空格、中文、&/#这类符号）兼容性比Android差很多，哪怕文件名看起来正常，也可能藏着不可见字符，导致路径解析失败。
• 目标目录权限不对：如果你选了iOS系统受限的目录来存文件，哪怕偶尔能成功，也会因为权限波动出现创建失败的情况。
• FileTransfer路径格式错误：iOS要求文件路径严格遵循file://开头的规范，或者使用File插件提供的官方目录常量，手动拼路径很容易踩坑。
• 文件冲突或锁定：如果目标路径已经有同名文件，且之前打开后没正常关闭被锁定，也会导致新文件无法创建。

具体解决方案 #

1. 先给文件名做“清洁处理” #

把文件名里的特殊字符去掉或替换，避免iOS解析路径时出错：

// 移除特殊字符，把空格替换成下划线，确保文件名合规
const sanitizedFileName = this.document.originalFileName
  .replace(/[^\w\s.-]/gi, '')
  .replace(/\s+/g, '_');

2. 用官方提供的可写入目录 #

别自己瞎拼路径，用IonicFile插件的目录常量，比如iOS允许安全写入的Documents目录：

import { File } from '@ionic-native/file/ngx';

// 注入File服务后，获取合法的目标目录
const targetDir = this.file.documentsDirectory;
const targetPath = targetDir + sanitizedFileName;

3. 下载前清理同名文件 #

先检查目标路径有没有已存在的同名文件，有的话直接删掉，避免冲突：

async viewFile() {
  this.analytics.trackEvent('document', 'view/download', this.document.originalFileName);
  const sanitizedFileName = this.document.originalFileName.replace(/[^\w\s.-]/gi, '').replace(/\s+/g, '_');
  const targetDir = this.file.documentsDirectory;
  const targetPath = targetDir + sanitizedFileName;

  // 检查并删除已存在的文件
  try {
    await this.file.checkFile(targetDir, sanitizedFileName);
    await this.file.removeFile(targetDir, sanitizedFileName);
  } catch (err) {
    // 文件不存在就忽略这个错误
  }

  // 执行下载逻辑
  const fileTransfer = this.transfer.create();
  fileTransfer.download(this.document.downloadUrl, targetPath)
    .then((entry) => {
      this.fileOpener.open(entry.toURL(), 'application/pdf')
        .then(() => console.log('文件打开成功'))
        .catch(err => console.error('打开文件出错', err));
    })
    .catch(err => console.error('下载出错', err));
}

4. 换成更稳定的现代API（强烈推荐） #

FileTransfer已经被Ionic标记为废弃了，官方推荐用HttpClient配合File插件来下载，兼容性和稳定性都更好：

async downloadAndOpenFile() {
  this.analytics.trackEvent('document', 'view/download', this.document.originalFileName);
  const sanitizedFileName = this.document.originalFileName.replace(/[^\w\s.-]/gi, '').replace(/\s+/g, '_');
  const targetDir = this.file.documentsDirectory;
  const targetPath = targetDir + sanitizedFileName;

  try {
    // 获取文件二进制数据
    const response = await this.http.get(this.document.downloadUrl, { responseType: 'blob' }).toPromise();
    // 写入文件（自动覆盖同名文件）
    await this.file.writeFile(targetDir, sanitizedFileName, response, { replace: true });
    // 打开文件
    await this.fileOpener.open(targetPath, 'application/pdf');
  } catch (err) {
    console.error('处理文件出错', err);
  }
}

额外排查小技巧 #

• 把报错的PDF文件名改成纯英文试试，看是不是特殊字符的锅。
• 打开Xcode的控制台，能看到更详细的iOS系统报错信息，比如具体是哪个路径创建失败。
• 检查Info.plist里有没有添加文件访问相关的权限描述，避免权限不足导致的问题。

内容的提问来源于stack exchange，提问作者Jack_Hardy