如何在本地Java环境中测试带环境变量的Azure Functions？

我之前开发Java版Azure Functions时也踩过这个环境变量的坑，给你几个具体的排查步骤，应该能解决问题：

• 检查local.settings.json的结构是否正确
  这是最容易出错的点！所有自定义环境变量必须放在Values节点下，不能直接放在根节点。正确的结构应该是这样：

  {
    "IsEncrypted": false,
    "Values": {
      "AzureWebJobsStorage": "UseDevelopmentStorage=true",
      "FUNCTIONS_WORKER_RUNTIME": "java",
      "someVariable": "你的变量值"
    }
  }
  

  要是把someVariable直接写在根节点，System.getenv()肯定拿不到值。

• 确认local.settings.json的位置和加载状态
  这个文件必须放在项目根目录（和pom.xml同级），不能放到src/main/resources里。另外，有时候VS Code的Azure Functions扩展可能没及时刷新配置，试试重启VS Code，或者右键点击local.settings.json，选择「Reload Azure Functions Project」（如果有这个选项的话）。

• 检查变量名拼写和大小写
  虽然Windows系统的环境变量不区分大小写，但macOS/Linux是区分的，而且Azure Functions框架会严格按照你在local.settings.json里的变量名生成环境变量。确保代码里System.getenv("someVariable")的变量名和配置文件里的完全一致，包括大小写。

• 关闭配置加密
  检查IsEncrypted字段是否设为false。如果是true，local.settings.json里的变量会被加密，本地运行时无法读取明文值。要是不小心加密了，可以右键点击文件选择「Decrypt Settings」解密。

• 试试用框架注解注入变量
  有时候直接用System.getenv()可能因为环境加载顺序的问题拿不到值，换成Azure Functions提供的@EnvironmentVariable注解注入会更可靠：

  @FunctionName("YourFunction")
  public HttpResponseMessage run(
          @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) HttpRequestMessage<Optional<String>> request,
          @EnvironmentVariable(name = "someVariable") String someVariable,
          final ExecutionContext context) {
      context.getLogger().info("拿到的变量值：" + someVariable);
      // 后续逻辑
  }
  

• 查看启动日志排查
  启动本地函数时，仔细看VS Code终端的输出日志。如果框架成功加载了local.settings.json，会打印出加载的配置信息，你可以看看有没有someVariable的身影；如果有报错信息，也能直接定位问题。

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