如何仅在开发环境中启用C# Azure Function的FunctionName属性？

你之前用#if DEBUG的方式是编译时控制，而Environment.IsDevelopment()是运行时判断，预处理器无法解析运行时表达式，所以不能直接那么写。下面提供几种可行的运行时控制方案：

方案一：函数内部直接判断环境（最简单） #

在函数执行前先检查当前环境，非开发环境直接返回错误响应，函数依然会被注册，但不会对外提供有效服务：

private const string HttpTestFn = "RunHttpTest";

[FunctionName(HttpTestFn)]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)
{
    // 检查是否为开发环境
    if (!Environment.IsDevelopment())
    {
        return new NotFoundResult(); // 或返回403 Forbidden禁止访问
    }

    // 你的测试函数逻辑
    log.LogInformation("执行开发环境专属测试函数");
    return new OkObjectResult("测试函数执行成功（仅开发环境可见）");
}

方案二：根据环境条件注册函数（彻底隐藏非开发环境的函数） #

通过IWebJobsStartup在启动阶段判断环境，仅在开发环境注册测试函数，这样非开发环境下函数不会被加载，完全不显示在运行时列表中：

1. 创建启动配置类：

using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

[assembly: WebJobsStartup(typeof(DevOnlyFunctionStartup))]
public class DevOnlyFunctionStartup : IWebJobsStartup
{
    public void Configure(IWebJobsBuilder builder)
    {
        // 获取环境信息
        var env = builder.Services.BuildServiceProvider().GetRequiredService<IHostEnvironment>();
        
        if (env.IsDevelopment())
        {
            // 仅在开发环境注册测试函数类
            builder.AddType<DevOnlyTestFunction>();
        }
    }
}

2. 将测试函数单独封装到类中：

public class DevOnlyTestFunction
{
    private const string HttpTestFn = "RunHttpTest";

    [FunctionName(HttpTestFn)]
    public async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
        ILogger log)
    {
        log.LogInformation("执行开发环境专属测试函数");
        return new OkObjectResult("测试函数执行成功（仅开发环境可见）");
    }
}

方案三：用配置开关灵活控制（不限于环境） #

如果需要更灵活的控制（比如在某些测试环境也启用），可以通过配置项开关实现：

1. 在local.settings.json（本地）和Azure应用配置（生产）中添加配置：

{
  "Values": {
    "EnableTestFunction": "true" // 开发/测试环境设为true，生产设为false
  }
}

2. 在函数中读取配置并判断：

private readonly IConfiguration _configuration;

// 通过构造函数注入配置
public MyFunctionClass(IConfiguration configuration)
{
    _configuration = configuration;
}

private const string HttpTestFn = "RunHttpTest";

[FunctionName(HttpTestFn)]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)
{
    bool isTestFunctionEnabled = bool.TryParse(_configuration["EnableTestFunction"], out bool result) ? result : false;
    if (!isTestFunctionEnabled)
    {
        return new NotFoundResult();
    }

    // 测试函数逻辑
    return new OkObjectResult("测试函数执行成功");
}

为什么原来的#if Environment.IsDevelopment()不行？ #

#if是编译时预处理器指令，只能识别编译阶段的符号（比如默认的DEBUG、RELEASE），而Environment.IsDevelopment()是运行时的方法调用，编译时无法解析这个表达式，因此会直接报错。

内容的提问来源于stack exchange，提问作者Tech with Thiru