Node.js中SQLITE_CANTOPEN错误：无法打开SQLite数据库文件排查

一、先搞定数据库路径的核心问题 #

Node.js里的文件相对路径是相对于进程启动目录，不是当前脚本文件所在目录，这是绝大多数人踩坑的点，别再试各种相对路径拼接了，直接用绝对路径：

• 借助__dirname（当前脚本的绝对目录）和path模块拼接路径，示例代码：

  const path = require('path');
  // 假设你的PersonModel.js在/api/models/目录下，对应数据库路径如下
  const dbAbsolutePath = path.join(__dirname, '../database/database.db');
  // 将这个绝对路径传给sqlite3的连接方法
  

• 紧急检查文件名拼写：你提到数据库文件是databse.db（少了一个字母'a'），先确认实际文件是否是database.db，拼写错误直接导致找不到文件。

二、排查文件与目录权限 #

• 确保Node.js进程能读取数据库文件和所在目录：
  • Linux/macOS执行命令赋权：

    chmod 644 /api/database/database.db
    chmod 755 /api/database/
    

  • Windows右键数据库文件→属性→安全，给运行Node.js的用户添加读取权限。
• 确认/api/database/目录存在：如果目录没创建，先通过代码或手动创建，代码示例：

  const fs = require('fs');
  const dbDir = path.join(__dirname, '../database');
  if (!fs.existsSync(dbDir)) {
    fs.mkdirSync(dbDir, { recursive: true });
  }
  

三、验证查询逻辑与数据库连接 #

• 写个独立脚本测试连接和查询，排除API层干扰：

  const sqlite3 = require('sqlite3').verbose();
  const path = require('path');
  const dbPath = path.join(__dirname, '../database/database.db');
  
  const db = new sqlite3.Database(dbPath, (err) => {
    if (err) {
      console.error('连接失败:', err.message);
      return;
    }
    console.log('数据库连接成功');
    // 直接查询person表
    db.all('SELECT * FROM person', (err, rows) => {
      if (err) {
        console.error('查询失败:', err.message);
      } else {
        console.log('查询结果:', rows);
      }
      db.close();
    });
  });
  

• 检查PersonModel里的查询语句：确认表名（是person还是persons）、字段名拼写正确，同时验证数据库里确实有数据。
• 检查API路由的错误处理：如果查询数据库时出错，是否直接返回了空数组而没有抛出错误？比如有没有漏掉try/catch或者错误回调的处理。

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