使用@azure/cosmos SDK时Azure Functions触发Internal 500内部错误

• 强制开启详细错误日志
  Azure Functions默认日志级别不足以捕获底层错误，修改host.json提升日志等级，获取更详细的报错信息：

  {
    "logging": {
      "logLevel": {
        "default": "Trace",
        "Function": "Trace",
        "Host.Aggregator": "Trace"
      }
    }
  }
  

  部署后重新触发函数，前往Application Insights或函数门户的日志面板查看具体异常，比如证书验证失败、SDK内部抛出的错误。

• 验证@azure/cosmos SDK版本兼容性
  Node 18对部分旧版本@azure/cosmos的API支持存在问题，比如早期版本未适配Node 18内置的fetch API。确认SDK版本为最新稳定版（建议>=3.16.0），更新package.json后重新部署测试。

• 检查CosmosDB网络访问规则
  本地开发时IP已加入CosmosDB白名单，但部署到Azure Functions后需调整网络配置：

  • 进入CosmosDB门户的网络设置，勾选「允许从所有Azure服务访问此账户」
  • 若函数部署在VNet中，需确认VNet与CosmosDB的对等连接配置正确，或添加函数所在子网到CosmosDB白名单。

• 排查部署包的依赖完整性
  本地依赖安装正常，但部署时可能因打包缺失依赖：

  • 若用VSCode扩展部署，确认部署时勾选了「包括所有依赖项」；若用Zip部署，需确保打包时包含完整的node_modules目录
  • 删除本地node_modules和package-lock.json，重新执行npm install后再部署，避免依赖缓存导致的版本不一致。

• 简化CosmosClient实例化代码
  即使硬编码密钥和端点，也要排除代码细节问题：

  • 确认端点格式为https://<account-name>.documents.azure.com:443/，无多余空格或字符
  • 验证密钥为CosmosDB的主密钥/只读密钥，复制时无截断
  • 先使用最简配置创建客户端，排除自定义参数干扰：

    import { CosmosClient } from "@azure/cosmos";
    const client = new CosmosClient({
      endpoint: "https://your-account.documents.azure.com:443/",
      key: "your-primary-key"
    });
    

• 确认函数应用的Node.js版本
  在Azure门户函数应用的配置>常规设置中，检查Node.js版本是否为18.x，与本地开发环境保持一致，避免版本差异引发的运行时问题。

• 直接测试CosmosDB端点连通性
  在函数中添加简单的网络测试代码，排查网络层面的问题：

  import axios from "axios";
  // 在函数入口添加测试逻辑
  const testCosmosConn = async () => {
    try {
      const res = await axios.get("https://your-account.documents.azure.com:443/", {
        headers: { "x-ms-version": "2021-05-15" },
        auth: { username: "", password: "your-primary-key" }
      });
      console.log("CosmosDB端点可访问：", res.status);
    } catch (err) {
      console.error("连通性测试失败：", err);
    }
  };
  testCosmosConn();
  

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