使用kdbxweb访问Keepass数据库返回KdbxError: BadSignature错误如何解决

你遇到的BadSignature错误核心原因是当前传入kdbxweb.Kdbx.load的不是合法的kdbx文件二进制内容，你代码里错误地将本地文件路径字符串直接传入base64ToBytes方法，该方法接收的是kdbx文件内容编码后的base64字符串，不是文件系统路径。

解决步骤 #

1. 正确读取kdbx文件的二进制内容 #

Node.js 环境

使用fs模块读取本地文件的二进制内容，再转换为符合要求的ArrayBuffer：

const fs = require('fs');
const password = kdbxweb.ProtectedValue.fromString('secret');
const credentials = new kdbxweb.Credentials(password);
// 读取文件为Buffer
const kdbxFileBuffer = fs.readFileSync('/home/chai/code/Kairos/src/e2e/db.kdbx');
// 转换为正确偏移的ArrayBuffer，避免node Buffer共享内存导致的异常
const file = kdbxFileBuffer.buffer.slice(kdbxFileBuffer.byteOffset, kdbxFileBuffer.byteOffset + kdbxFileBuffer.byteLength);
const db = await kdbxweb.Kdbx.load(file, credentials);

浏览器环境

浏览器无法直接读取本地文件路径，需要通过文件选择控件让用户选择文件后，用FileReader读取为ArrayBuffer再传入。

2. 其他排查方向 #

如果修正文件读取逻辑后依然报错，可按以下顺序排查：

• 检查你的kdbx数据库是否同时配置了密码+密钥文件，如果有，创建Credentials时需要同时传入密码和密钥文件内容：

  // keyFileBytes为密钥文件的Uint8Array内容
  const credentials = new kdbxweb.Credentials(password, keyFileBytes);
  

• 确认你使用的kdbxweb版本支持你数据库的KDBX格式版本，主流新版本kdbxweb均支持KDBX3、KDBX4格式。
• 如果你确实是通过base64格式传递文件内容，确保你传入base64ToBytes的是完整kdbx文件转码后的base64字符串，而非本地路径。

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