新项目应直接使用.net isolated模型，因其支持.net 6+、避免组件冲突、提供完整进程控制和标准依赖注入，而in-process模型已不支持.net 6+且绑定与日志机制不兼容。
新项目直接用 .NET Isolated 模型，别碰 In-process——它已不支持 .NET 6+，且绑定行为和日志机制都和隔离模型不兼容，硬切会导致 HttpRequestData 找不到、FunctionContext 初始化失败等编译或运行时错误。
选对模板：func init 或 Visual Studio 新建项目时确认是 .NET Isolated
VS Code 中运行 func init 时，必须手动选择 .NET Isolated（不是默认的 “dotnet”），否则生成的是已弃用的进程内项目；Visual Studio 2022 创建新项目时，模板名是 Azure Functions，但关键要看目标框架是否为 .NET 6、.NET 7 或 .NET 8——若显示 .NET Core 3.1 或 .NET Framework，说明选错了模板。项目文件里应有 <targetframework>net8.0</targetframework> 和 <azurefunctionsversion>v4</azurefunctionsversion>，缺一不可。
HTTP 函数写法：用 HttpRequestData 而不是 HttpRequest
隔离模型下，函数参数类型完全变了：HttpRequestData 和 HttpResponseData 是必须的，传统 ASP.NET Core 的 HttpRequest/HttpResponse 会编译报错或运行时抛出 InvalidOperationException: Unable to resolve service for type 'Microsoft.AspNetCore.Http.HttpRequest'。常见错误包括：
- 误写
public static async Task<iactionresult> Run(...)</iactionresult>—— 隔离模型不支持IActionResult - 漏掉
[HttpTrigger]特性，或参数顺序写反（HttpRequestData必须在FunctionContext前） - 响应体用
response.WriteString()后没调return response，导致空响应或 500 错误
正确写法示例：
public static class HttpExample
{
[Function("HttpExample")]
public static HttpResponseData Run(
[HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequestData req,
FunctionContext executionContext)
{
var logger = executionContext.GetLogger("HttpExample");
logger.LogInformation("Request received");
var response = req.CreateResponse(HttpStatusCode.OK);
response.Headers.Add("Content-Type", "application/json");
using var writer = new StreamWriter(response.Body);
writer.Write("{\"message\":\"Hello\"}");
return response;
}
}
本地调试和部署前必查三件事
本地 func start 启动后打不开 http://localhost:7071/api/HttpExample？先核对：
-
local.settings.json里AzureWebJobsStorage值不能是UseDevelopmentStorage=true（这是旧模型写法），新模型必须显式填 Azurite 连接字符串或实际 Storage Account 连接串，否则 HTTP 触发器注册失败 - 函数方法必须是
public static，且类名无命名空间冲突（例如不要叫Function1且多个同名类存在） - 部署到 Azure 前，确保 Azure Functions Core Tools 版本 ≥ 4.0.5907（
func --version查看），低版本对 .NET 8 支持不全，会卡在构建阶段或提示Could not load file or assembly 'Microsoft.Azure.Functions.Worker'
真正容易被忽略的是绑定扩展注册——哪怕只用 HTTP 触发器，Program.cs 里仍要调用 hostBuilder.ConfigureFunctionsWorkerDefaults()，否则本地能跑、部署后 404；另外，AuthorizationLevel 设为 Anonymous 仅限测试，生产环境必须配合 Microsoft Entra ID 或函数密钥验证，否则所有请求都会被拒绝。
