Visual Studio中语言服务端与客户端JSON-RPC连接丢失的原因及解决方法

可能的原因 #

• 进程启动路径错误：Node可执行文件路径未被正确识别，或者server.js的路径不正确，导致服务端进程启动后立即退出，连接直接断开。
• 未捕获服务端错误输出：服务端启动失败时会向标准错误流输出信息，但当前代码未监听该流，无法排查启动失败原因，进而导致连接丢失。
• 流编码不匹配：Visual Studio进程的标准流编码与Node服务端的stdio编码不一致，导致JSON-RPC消息解析失败，触发连接中断。
• 进程实例被GC回收：Process对象仅在方法内局部声明，方法执行完成后被GC回收，导致服务端进程被终止，连接丢失。
• 服务端启动延迟：客户端在服务端尚未完成初始化时就发送请求，此时连接还未完全建立，引发连接丢失错误。

解决办法 #

1. 修复进程启动路径 #

• 指定Node可执行文件的绝对路径，避免环境变量查找失败：

  FileName = @"C:\Program Files\nodejs\node.exe"
  

• 设置WorkingDirectory为server.js所在的目录，确保能正确找到文件：

  StartInfo.WorkingDirectory = @"C:\path\to\your\language-server";
  

2. 监听服务端错误输出 #

添加错误流监听，捕获服务端启动时的错误信息，便于排查问题：

process.ErrorDataReceived += (sender, e) => {
    if (!string.IsNullOrEmpty(e.Data))
    {
        System.Diagnostics.Debug.WriteLine($"Language Server Error: {e.Data}");
    }
};
process.BeginErrorReadLine();

3. 统一标准流编码 #

将Visual Studio进程的标准流编码设置为UTF-8，与Node服务端保持一致：

StartInfo.StandardOutputEncoding = System.Text.Encoding.UTF8;
StartInfo.StandardInputEncoding = System.Text.Encoding.UTF8;

4. 保留Process实例引用 #

在类级别声明Process变量，避免被GC回收：

private Process _languageServerProcess;

public async Task<Connection> ActivateAsync(CancellationToken token)
{
    _languageServerProcess = new Process
    {
        StartInfo = new ProcessStartInfo
        {
            // 原有配置
        }
    };

    // 启动及连接逻辑
}

5. 验证服务端本身可用性 #

在命令行中手动运行服务端命令，确认服务端能正常启动并处理请求：

node server.js --stdio

手动输入JSON-RPC格式的初始化请求，看服务端是否能正常响应，排除服务端自身的问题。

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