AgentScope Studio安装失败应为无法编译sqlite3的解决方案2025.12.2

[RePlayer2]

记录一下我在安装AgentScope Studio的时候出现关于sqlite3无法正常编译解决方案
如果你也遇到一样的问题可以尝试以下解决方案

前提：我的电脑是windows 11系统,使用npm install -g @agentscope/studio # or npm install @agentscope/studio会出现下面问题

1.这是关于我的报错问题，
即使我已经安装了
MSVC v143 - VS 2022 C++ x64/x86 生成工具
Windows 10/11 SDK

和对应的npm和node版本
npm --version
11.6.2

node --version
v24.11.1

任然出现下面报错

npm install
npm warn deprecated [email protected]: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm warn deprecated @npmcli/[email protected]: This functionality has been moved to @npmcli/fs
npm warn deprecated [email protected]: This package is no longer supported.
npm warn deprecated [email protected]: Rimraf versions prior to v4 are no longer supported
npm warn deprecated [email protected]: Glob versions prior to v9 are no longer supported
npm warn deprecated [email protected]: This package is no longer supported.
npm warn deprecated [email protected]: This package is no longer supported.
npm warn cleanup Failed to remove some directories [
npm warn cleanup   [
npm warn cleanup     '\\\\?\\H:\\agentscope_studio\\agentscope-studio\\node_modules',
npm warn cleanup     [Error: EPERM: operation not permitted, rmdir 'H:\agentscope_studio\agentscope-studio\node_modules\@grpc\grpc-js\build\src\generated\xds\data'] {
npm warn cleanup       errno: -4048,
npm warn cleanup       code: 'EPERM',
npm warn cleanup       syscall: 'rmdir',
npm warn cleanup       path: 'H:\\agentscope_studio\\agentscope-studio\\node_modules\\@grpc\\grpc-js\\build\\src\\generated\\xds\\data'
npm warn cleanup     }
npm warn cleanup   ]
npm warn cleanup ]
npm error code 1
npm error path H:\agentscope_studio\agentscope-studio\node_modules\sqlite3
npm error command failed
npm error command C:\WINDOWS\system32\cmd.exe /d /s /c prebuild-install -r napi || node-gyp rebuild
npm error (node:27220) [DEP0176] DeprecationWarning: fs.R_OK is deprecated, use fs.constants.R_OK instead
npm error (Use `node --trace-deprecation ...` to show where the warning was created)
npm error prebuild-install warn install unable to verify the first certificate; if the root CA is installed locally, try running Node.js with --use-system-ca
npm error gyp info it worked if it ends with ok
npm error gyp info using [email protected]
npm error gyp info using [email protected] | win32 | x64
npm error (node:13752) [DEP0060] DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead.
npm error (Use `node --trace-deprecation ...` to show where the warning was created)
npm error (node:13752) [DEP0190] DeprecationWarning: Passing args to a child process with shell option true can lead to security vulnerabilities, as the arguments are not escaped, only concatenated.
npm error gyp info find Python using Python version 3.11.9 found at "C:\Users\1\AppData\Local\Programs\Python\Python311\python.exe"
npm error gyp ERR! find VS
npm error gyp ERR! find VS msvs_version not set from command line or npm config
npm error gyp ERR! find VS VCINSTALLDIR not set, not running in VS Command Prompt
npm error gyp ERR! find VS checking VS2022 (17.14.36717.8) found at:
npm error gyp ERR! find VS "D:\vc++"
npm error gyp ERR! find VS - found "Visual Studio C++ core features"
npm error gyp ERR! find VS - found VC++ toolset: v143
npm error gyp ERR! find VS - missing any Windows SDK
npm error gyp ERR! find VS could not find a version of Visual Studio 2017 or newer to use
npm error gyp ERR! find VS looking for Visual Studio 2015
npm error gyp ERR! find VS - not found
npm error gyp ERR! find VS not looking for VS2013 as it is only supported up to Node.js 8
npm error gyp ERR! find VS
npm error gyp ERR! find VS **************************************************************
npm error gyp ERR! find VS You need to install the latest version of Visual Studio
npm error gyp ERR! find VS including the "Desktop development with C++" workload.
npm error gyp ERR! find VS For more information consult the documentation at:
npm error gyp ERR! find VS https://github.com/nodejs/node-gyp#on-windows
npm error gyp ERR! find VS **************************************************************
npm error gyp ERR! find VS
npm error gyp ERR! configure error
npm error gyp ERR! stack Error: Could not find any Visual Studio installation to use
npm error gyp ERR! stack     at VisualStudioFinder.fail (H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\find-visualstudio.js:122:47)
npm error gyp ERR! stack     at H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\find-visualstudio.js:75:16
npm error gyp ERR! stack     at VisualStudioFinder.findVisualStudio2013 (H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\find-visualstudio.js:363:14)
npm error gyp ERR! stack     at H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\find-visualstudio.js:71:14
npm error gyp ERR! stack     at H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\find-visualstudio.js:384:16
npm error gyp ERR! stack     at H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\util.js:54:7
npm error gyp ERR! stack     at H:\agentscope_studio\agentscope-studio\node_modules\node-gyp\lib\util.js:33:16
npm error gyp ERR! stack     at ChildProcess.exithandler (node:child_process:424:5)
npm error gyp ERR! stack     at ChildProcess.emit (node:events:508:28)
npm error gyp ERR! stack     at maybeClose (node:internal/child_process:1101:16)
npm error gyp ERR! System Windows_NT 10.0.26100
npm error gyp ERR! command "D:\\node_js\\node.exe" "H:\\agentscope_studio\\agentscope-studio\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild"
npm error gyp ERR! cwd H:\agentscope_studio\agentscope-studio\node_modules\sqlite3
npm error gyp ERR! node -v v24.11.1
npm error gyp ERR! node-gyp -v v8.4.1
npm error gyp ERR! not ok
npm error A complete log of this run can be found in: C:\Users\1\AppData\Local\npm-cache\_logs\2025-12-02T07_33_31_149Z-debug-0.log

H:\agentscope_studio\agentscope-studio>
H:\agentscope_studio\agentscope-studio>
H:\agentscope_studio\agentscope-studio>
H:\agentscope_studio\agentscope-studio>
H:\agentscope_studio\agentscope-studio>
H:\agentscope_studio\agentscope-studio>npm run dev

> @agentscope/[email protected] dev
> concurrently "npm run dev:client" "npm run dev:server"

'concurrently' 不是内部或外部命令，也不是可运行的程序
或批处理文件。

H:\agentscope_studio\agentscope-studio>as_studio
node:internal/modules/cjs/loader:1424
  throw err;
  ^

Error: Cannot find module 'C:\Users\1\AppData\Roaming\npm\node_modules\@agentscope\studio\bin\cli.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1421:15)
    at defaultResolveImpl (node:internal/modules/cjs/loader:1059:19)
    at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1064:22)
    at Module._load (node:internal/modules/cjs/loader:1227:37)
    at TracingChannel.traceSync (node:diagnostics_channel:328:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
    at Module.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:154:5)
    at node:internal/main/run_main_module:33:47 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

Node.js v24.11.1

2.下面是我的解决方案:
（1）通过源码安装
你可以参考下面地址
https://github.com/agentscope-ai/agentscope-studio

主要使用下面命令拉取源码安装

git clone https://github.com/agentscope-ai/agentscope-studio
cd agentscope-studio
npm install
npm run dev

但这时候使用 npm install 任然会出现error

(2)使用的npm我重新安装了更加兼容版本的sqlite3来解决这个问题

[1]删除了原本目录的sqlite3
npm uninstall sqlite3 # 先删除已安装的不完整依赖

[2]强制删除了node_modules残留

cd H:\agentscope_studio\agentscope-studio # 进入项目目录
Remove-Item -Recurse -Force node_modules -ErrorAction SilentlyContinue # 强制删除node_modules（PowerShell命令，无视文件占用）
Remove-Item package-lock.json -ErrorAction SilentlyContinue # 删除锁文件

[3]安装当前环境的sqlite3

cd \packages\server # 进入server子包目录

npm install [email protected] --registry=https://registry.npmmirror.com --sqlite3_binary_host_mirror=https://github.com/TryGhost/node-sqlite3/releases/download/  # 在server子包中安装适配TypeORM的sqlite3（指定兼容版本）

#验证是否安装成功
node -e "require('sqlite3'); console.log('sqlite3加载成功')"

若输出sqlite3加载成功：说明安装正常；

[4]重新安装库和测试
在\agentscope-studio目录下

cd H:\agentscope_studio\agentscope-studio
npm install # 重新安装检查缺失
npm run dev

成功运行参考示例: