Cannot read properties of undefined (reading 'writeFileSync')

### 解决 `uni.uploadFile` 上传 Base64 数据时的 `'Cannot read properties of undefined (reading 'writeFileSync')` 错误 在使用 `uni.uploadFile` 上传 Base64 数据时，如果遇到 `'Cannot read properties of undefined (reading 'writeFileSync')` 错误，通常是因为尝试调用 `uni.getFileSystemManager().writeFileSync` 方法时，`wx.env.USER_DATA_PATH` 或其他相关路径未正确初始化或不可用[^1]。 以下是对该问题的详细分析和解决方案： #### 错误原因 1. **环境问题**：`wx.env.USER_DATA_PATH` 是微信小程序特有的 API，但在非微信小程序环境下（如 H5 或其他平台），该属性可能不存在，导致调用 `writeFileSync` 时出现错误。 2. **路径未定义**：即使在支持的小程序环境中，如果未正确初始化用户数据路径，也可能导致路径为 `undefined`。 3. **API 使用不当**：`uni.getFileSystemManager()` 的方法调用可能存在问题，例如未正确处理异步操作或文件写入失败。 #### 解决方案 ##### 方法一：检查运行环境并动态调整路径 在不同平台上，用户数据路径的获取方式可能不同。可以通过检测运行环境来动态设置路径： ```javascript function getTempPath() { if (uni.getSystemInfoSync().platform === 'devtools' || uni.getSystemInfoSync().platform === 'wechat') { return `${wx.env.USER_DATA_PATH}/temp_file.png`; } else { // 针对其他平台（如 H5），需要手动指定路径或使用 Blob 转换 return 'data:image/png;base64,...'; // 示例：直接返回 Base64 数据 } } ``` ##### 方法二：将 Base64 数据转换为临时文件 在支持的环境中，可以将 Base64 数据转换为临时文件并上传。以下是完整的实现代码： ```javascript function base64ToFile(base64, fileName) { const base64Data = base64.split(',')[1]; const filePath = getTempPath(fileName); try { const buffer = uni.arrayBufferFromString(atob(base64Data)); uni.getFileSystemManager().writeFileSync(filePath, buffer, 'binary'); return filePath; } catch (e) { console.error('Base64 转换失败:', e); return null; } } function uploadBase64WithParams(base64, params, serverUrl) { const tempFilePath = base64ToFile(base64, 'temp_image.png'); if (!tempFilePath) { console.error('无法生成临时文件'); return; } uni.uploadFile({ url: serverUrl, filePath: tempFilePath, name: 'file', formData: params, success: (res) => { console.log('上传成功:', res.data); }, fail: (err) => { console.error('上传失败:', err); } }); } ``` ##### 方法三：针对 H5 环境的兼容性处理 在 H5 环境中，由于缺乏 `wx.env.USER_DATA_PATH`，可以直接通过 `FormData` 和 `fetch` 实现上传功能： ```javascript function uploadBase64ToH5(base64, params, serverUrl) { const blob = base64ToBlob(base64); // 将 Base64 转换为 Blob 对象 const formData = new FormData(); formData.append('file', blob, 'temp_image.png'); // 设置文件字段名和文件名 Object.keys(params).forEach(key => { formData.append(key, params[key]); }); fetch(serverUrl, { method: 'POST', body: formData }) .then(response => response.json()) .then(data => { console.log('上传成功:', data); }) .catch(error => { console.error('上传失败:', error); }); } function base64ToBlob(base64) { const base64Data = atob(base64.split(',')[1]); const arrayBuffer = new Uint8Array(base64Data.length); for (let i = 0; i < base64Data.length; i++) { arrayBuffer[i] = base64Data.charCodeAt(i); } return new Blob([arrayBuffer], { type: 'image/png' }); } ``` #### 注意事项 - 在小程序环境中，确保正确初始化 `wx.env.USER_DATA_PATH`，并在调用 `writeFileSync` 前验证路径是否存在。 - 在 H5 环境中，推荐使用 `FormData` 和 `fetch` 替代 `uni.uploadFile`，以实现更好的兼容性[^2]。 - 如果需要同时支持多平台，请根据运行环境动态选择上传方式。 --- ###