Electron打包AppImage时cregr_db.db未包含导致运行报错怎么办

• 路径逻辑错误：代码中直接写cregr_db.db属于相对路径，Electron应用打包后，相对路径的基准是启动应用时的shell工作目录，不是应用自身的资源存放目录，从任意非应用目录启动AppImage时，路径会指向错误位置。
• 配置字段误用：当前使用的extraFiles配置，作用是将指定文件输出到打包生成的安装包同级目录，不会被打进AppImage镜像内部，移动AppImage时未同步携带同级db文件、或者启动路径变化都会触发文件找不到的错误。
• 权限逻辑不兼容：AppImage运行时为只读挂载模式，即便把db文件打进AppImage内部，SQLite运行时需要写入锁、事务日志、业务数据，直接操作只读路径下的db文件必然触发IO异常。

1. 调整数据库路径读写逻辑 #

不要直接操作项目内的初始db文件，首次启动时将初始db复制到系统分配给应用的可写用户数据目录下，再连接该路径的数据库，该路径不会随应用启动位置变化，且默认拥有读写权限。
替换原有数据库打开代码为以下内容：

const fs = require("fs")
const path = require("path")
const sqlite = require("aa-sqlite")
const { app } = require("electron")

// 应用可写的用户数据目录下的数据库路径，路径固定不受启动位置影响
const userDbPath = path.join(app.getPath('userData'), 'cregr_db.db')

// 首次启动检测：用户目录不存在db时，从应用资源目录复制初始模板db
if (!fs.existsSync(userDbPath)) {
  // 区分开发/生产环境的初始db路径
  const sourceDbPath = app.isPackaged
    ? path.join(process.resourcesPath, 'cregr_db.db')
    : path.join(__dirname, 'cregr_db.db')
  fs.copyFileSync(sourceDbPath, userDbPath)
}

// 连接可写路径下的数据库
await sqlite.open(userDbPath);

2. 修正electron-builder打包配置 #

将原配置中的extraFiles替换为extraResources，该字段会将初始db文件打包进应用内部的resources目录，生产环境下可通过process.resourcesPath正常读取：

"build": {
  "appId": "crergr",
  "linux": {
    "target": [
      "AppImage"
    ],
    "icon": "icon512.png"
  },
  "win": {
    "target": "NSIS",
    "icon": "icon256.ico"
  },
  "extraResources": [
    {
      "from": "cregr_db.db",
      "to": "cregr_db.db"
    }
  ]
}

3. 验证注意点 #

• 重新打包前先清空dist、build目录的旧缓存，避免旧配置的打包产物干扰测试
• 测试时不要直接在项目根目录运行打包产物，放到任意其他路径启动验证，确认数据库读写正常
• 不要尝试直接修改process.resourcesPath路径下的文件，该路径在AppImage模式下为只读，所有写入操作必须放在app.getPath('userData')对应的目录下

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