Azure Functions特定类名导致函数无法暴露问题求助

问题现象 #

当Azure Functions的函数类命名为Workflows或WorkflowTemplates时，类内标记了[Function]特性的方法无法被Functions宿主识别并注册为可访问的函数端点，请求对应路由会返回404 Not Found；但将类名修改为其他名称（如WorkflowFunctions）后，函数可正常注册，请求返回200 OK。

复现代码与结果 #

问题代码（类名Workflows）

[RequestHttpHeader("Authorization", isRequired: true)]
public class Workflows
{
    private readonly IPhoenixLogger _logger;

    public Workflows(IPhoenixLogger logger)
    {        
        _logger = logger;        
    }
 
    [ProducesResponseType(typeof(IEnumerable<Workflow>), (int)HttpStatusCode.OK)]
    [ProducesResponseType(typeof(string), (int)HttpStatusCode.BadRequest)]
    [ProducesResponseType((int)HttpStatusCode.Unauthorized)]
    [Function("GetWorkflows")]
    public async Task<IActionResult> RunGetWorkflows(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "Workflows")] HttpRequest req
    )
    {
        return await Middleware.Run(async () => await GetWorkflows(req), req, _logger);
    }
}

HttpRequest: Get /api/Workflows - Not found 404

正常代码（类名WorkflowFunctions）

[RequestHttpHeader("Authorization", isRequired: true)]
public class WorkflowFunctions
{
    private readonly IPhoenixLogger _logger;

    public WorkflowFunctions(IPhoenixLogger logger)
    {        
        _logger = logger;        
    }
 
    [ProducesResponseType(typeof(IEnumerable<Workflow>), (int)HttpStatusCode.OK)]
    [ProducesResponseType(typeof(string), (int)HttpStatusCode.BadRequest)]
    [ProducesResponseType((int)HttpStatusCode.Unauthorized)]
    [Function("GetWorkflows")]
    public async Task<IActionResult> RunGetWorkflows(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "Workflows")] HttpRequest req
    )
    {
        return await Middleware.Run(async () => await GetWorkflows(req), req, _logger);
    }
}

HttpRequest: Get /api/Workflows - OK 200

原因分析 #

这类特定类名引发问题的核心原因是：Azure Functions宿主在扫描并加载函数类时，会对类名进行过滤，Workflows、WorkflowTemplates这类名称与Azure平台内置的Logic Apps工作流服务的核心组件命名重合，宿主会将这些类判定为系统内部组件而非用户自定义的函数类，从而跳过函数注册流程。

解决方案与规避方法 #

• 最直接的规避方式：修改函数类的名称，避免使用Workflows、WorkflowTemplates这类与Azure内置服务同名的命名，改用如WorkflowFunctions、CustomWorkflows等自定义名称。
• 显式配置函数路由（可选）：如果必须保留类名，可以尝试在HttpTrigger的Route属性中指定更独特的路由路径（如Route = "custom-workflows"），同时在[Function]特性中显式指定函数名称，确保与内置路由无冲突，但此方法无法彻底解决类名被过滤的问题，优先推荐修改类名。

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