Java Azure Functions中local.settings.json被忽略的问题求助

Java Azure Functions 完全支持像 C# Functions 一样使用 local.settings.json 管理本地应用设置，你的问题大概率是文件位置、配置格式或运行配置的问题，以下是具体排查和解决步骤：

1. 确认文件位置正确性 #

local.settings.json 必须放置在项目根目录（与 host.json 同级），不能放在 src/main/resources 或其他子目录下。Azure Functions Core Tools 只会读取根目录下的该配置文件。

2. 检查配置格式规范性 #

配置文件必须遵循标准 JSON 结构，所有应用设置必须放在 Values 节点下，示例如下：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "java",
    "YOUR_CUSTOM_SETTING": "your-custom-value"
  }
}

注意：FUNCTIONS_WORKER_RUNTIME 必须设置为 java，否则 Core Tools 会识别错误运行时，导致配置被忽略。

3. 验证 IntelliJ 运行配置 #

• 确保运行配置中未手动添加与 local.settings.json 重复的环境变量，手动添加的变量会覆盖配置文件中的值，甚至导致读取异常。
• 检查运行配置的「Working directory」是否指向项目根目录，路径错误会导致 Core Tools 无法找到配置文件。

4. 用 Core Tools 命令行验证 #

脱离 IntelliJ，在项目根目录直接执行：

func start

如果命令行能正常加载配置中的设置，说明问题出在 IntelliJ 运行配置；如果命令行也无法读取，需再次检查文件位置和格式。

5. 正确读取配置的代码示例 #

确保在 Java 代码中使用正确的方式读取设置：

import com.microsoft.azure.functions.*;
import java.util.Optional;

public class MyFunction {
    @FunctionName("MyFunction")
    public HttpResponseMessage run(
            @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) HttpRequestMessage<Optional<String>> request,
            final ExecutionContext context) {
        // 方式1：通过环境变量读取
        String customSetting = System.getenv("YOUR_CUSTOM_SETTING");
        // 方式2：通过 ExecutionContext 读取
        String anotherSetting = context.getConfiguration().get("ANOTHER_SETTING");
        
        context.getLogger().info("Custom setting value: " + customSetting);
        return request.createResponseBuilder(HttpStatus.OK).body("Setting loaded: " + customSetting).build();
    }
}

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