Electron获取目录文件路径报错：路径参数类型异常如何解决？

DevOps 小满

2026-7-11

解决Electron调用getFiles时参数类型错误的问题

这个错误的核心原因是：你以为传了字符串，但实际传给主进程的是一个Event实例，而非目标字符串。以下是具体排查和解决步骤：

1. 检查渲染进程中调用`getFiles`的方式

最常见的问题是在DOM事件绑定中误传了事件对象：

错误示例（通过addEventListener绑定）：

// 错误：点击时会自动把Event对象作为第一个参数传给getFiles
document.querySelector('#btn').addEventListener('click', getFiles);

正确写法（用箭头函数包裹，明确传递字符串参数）：

document.querySelector('#btn').addEventListener('click', () => {
  getFiles('somedirectory');
});

如果是用内联onclick属性，确保写法正确：

<!-- 正确写法 -->
<button onclick="getFiles('somedirectory')">获取文件</button>

2. 验证Preload脚本的IPC暴露逻辑

确保preload.js中正确传递参数，没有混淆事件对象：

// preload.js
const { contextBridge, ipcRenderer } = require('electron');

contextBridge.exposeInMainWorld('electronAPI', {
  getFiles: (targetPath) => {
    // 可添加日志验证参数：console.log('Received path in preload:', targetPath);
    return ipcRenderer.invoke('files:getFiles', targetPath);
  }
});

3. 检查主进程的IPC处理函数

主进程的ipcMain.handle方法第一个参数是event对象，第二个才是你传递的路径参数，别搞混顺序：

// main.js
const { ipcMain } = require('electron');
const fs = require('fs').promises;

ipcMain.handle('files:getFiles', async (event, targetPath) => {
  // 可添加日志验证参数：console.log('Received path in main:', targetPath);
  try {
    return await fs.readdir(targetPath);
  } catch (err) {
    console.error('读取目录失败:', err);
    throw err;
  }
});