Electron.js存图功能无报错但文件未保存为.png格式问题排查
问题根因定位
核心问题出在日期字符串的生成逻辑,两个bug直接导致文件无扩展名、无报错:
- 日期字符串包含Windows系统禁止的非法文件名字符
直接调用Date()返回的本地时间字符串,本身带有时间部分的冒号(例如14:30:45格式)。原代码仅对字符串中第一个出现的冒号做了替换,剩余的冒号会保留在最终拼接的文件名内。
Windows文件命名规则完全禁止冒号出现在文件名中,系统写盘时会自动截断冒号及后面的所有内容——文件名里的.png后缀刚好处于冒号之后,会被完全切掉。这个截断操作发生在系统内核层面,Node.js的fs模块无法感知异常,因此不会抛出任何报错,最终就会生成无扩展名的普通文件。 - 文件后缀重复拼接的冗余逻辑
模块初始化时已经给date变量拼接了一次.png,后续fs.writeFile生成存储路径时,又基于date变量再拼接一次.png,就算没有上述非法字符问题,最终生成的文件名也会是xxx.png.png的错误格式。
代码修正方案
替换原有存在问题的日期生成逻辑,全程规避非法字符、去掉冗余拼接:
const fs = require('fs') const path = require('path') const logError = err => err && console.error(err) // 生成无非法字符、格式统一的安全文件名 function getSafeFileName() { const now = new Date() const year = now.getFullYear() const month = String(now.getMonth() + 1).padStart(2, '0') const day = String(now.getDate()).padStart(2, '0') const hour = String(now.getHours()).padStart(2, '0') const minute = String(now.getMinutes()).padStart(2, '0') const second = String(now.getSeconds()).padStart(2, '0') return `${year}${month}${day}_${hour}${minute}${second}.png` } exports.save = (picturesPath, contents) => { const base64Data = contents.replace(/^data:image\/png;base64,/, '') // 直接使用预先生成好的带后缀的安全文件名拼接路径,避免重复拼接 fs.writeFile( path.join(picturesPath, getSafeFileName()), base64Data, { encoding: 'base64' }, logError ) } exports.getPicturesDir = app => { return path.join(app.getPath('pictures'), 'photobombth') } exports.mkdir = picturesPath => { fs.stat(picturesPath, (err, stats) => { if (err && err.code !== 'ENOENT') return logError(err) else if (err || !stats.isDirectory()) fs.mkdir(picturesPath, logError) }) }
优化建议
- 生成文件名后增加一次统一的非法字符替换,把所有
\/:*?"<>|的系统禁止字符全部替换为下划线,避免跨平台运行时复现同样的文件截断问题 - 开发阶段可临时增加路径打印日志,确认实际生成的文件路径、文件名是否符合预期;当前错误处理逻辑仅在控制台打印错误,遇到路径无权限、写盘失败等问题时无显性反馈,可根据需要增加弹窗提示。
内容的提问来源于stack exchange,提问作者stackoverflowuser
相关产品推荐
相关产品推荐

