解决lsp-ai与nvim-lspconfig集成中的JSON反序列化问题

在使用lsp-ai与nvim-lspconfig进行集成时，开发者可能会遇到一个常见的配置错误，导致服务器端出现JSON反序列化问题。本文将深入分析这个问题的根源，并提供完整的解决方案。

问题现象分析

当开发者按照常规方式配置lsp-ai的LSP服务器时，可能会在日志中看到类似以下的错误信息：

ERROR lsp_ai: invalid length 0, expected struct FileStore with 1 element

这个错误表明服务器在尝试解析客户端发送的初始化选项时遇到了问题。虽然服务器仍在运行并能够收发消息，但核心功能可能无法正常工作。

问题根源

问题的本质在于Neovim的Lua到JSON转换机制。在Lua中，空表{}会被默认转换为JSON的空数组[]，而lsp-ai服务器期望的是一个空对象{}。这种类型不匹配导致了反序列化失败。

具体来说，在配置中的file_store字段：

file_store = {}

在Lua中被转换为JSON的[]，而服务器期望的是{}。

解决方案

要解决这个问题，我们需要确保配置数据能够被正确转换为服务器期望的JSON格式。以下是两种可行的解决方案：

方案一：使用JSON字符串直接定义配置

这是最可靠的解决方案，可以完全控制最终的JSON结构：

local lsp_ai_init_options_json = [[
{
  "memory": {
    "file_store": {}
  },
  "models": {
    "model1": {
      "type": "llama_cpp",
      "file_path": "/path/to/model.gguf",
      "n_ctx": 2048
    }
  }
}]]

local config = {
  cmd = {'lsp-ai'},
  init_options = vim.fn.json_decode(lsp_ai_init_options_json)
}

方案二：使用Lua表结构但确保正确转换

如果坚持使用Lua表结构，可以这样定义：

local config = {
  cmd = {'lsp-ai'},
  init_options = {
    memory = {
      file_store = vim.empty_dict() -- 确保转换为JSON对象
    },
    models = {
      model1 = {
        type = "llama_cpp",
        file_path = "/path/to/model.gguf",
        n_ctx = 2048
      }
    }
  }
}

完整配置示例

以下是一个完整的lsp-ai配置示例，包含了模型定义和代码补全参数：

local lsp_ai_config = {
  cmd = { 'lsp-ai', '--use-seperate-log-file' },
  filetypes = { 'python', 'lua', 'javascript' },
  root_dir = vim.loop.cwd(),
  init_options = vim.fn.json_decode([[
  {
    "memory": {
      "file_store": {}
    },
    "models": {
      "llama": {
        "type": "llama_cpp",
        "file_path": "/path/to/model.gguf",
        "n_ctx": 2048
      },
      "ollama": {
        "type": "ollama",
        "model": "deepseek-coder"
      }
    },
    "completion": {
      "model": "ollama",
      "parameters": {
        "max_context": 2000,
        "max_new_tokens": 32
      }
    }
  }
  ]])
}

-- 自动启动LSP
vim.api.nvim_create_autocmd("FileType", {
  pattern = lsp_ai_config.filetypes,
  callback = function(args)
    vim.lsp.start(lsp_ai_config, { bufnr = args.buf })
  end
})

最佳实践建议

1. 使用JSON字符串定义复杂配置：对于包含嵌套结构的配置，使用JSON字符串可以避免Lua到JSON转换的歧义。

2. 启用详细日志：在调试阶段，添加--use-seperate-log-file参数和设置LSP_AI_LOG=DEBUG环境变量可以帮助诊断问题。

3. 逐步验证配置：先使用最简单的配置验证连接是否正常，再逐步添加复杂功能。

4. 注意模型路径和权限：确保模型文件路径正确，并且Neovim进程有访问权限。

通过以上方法，开发者可以避免JSON反序列化问题，并成功将lsp-ai集成到Neovim的LSP生态系统中。