本地运行Azure Functions函数未加载且无法读取配置文件的问题求助

我有一个Azure Http Trigger函数，编译成功且运行无报错，但函数并未加载。在verbose模式下运行时，日志仅显示Host启动完成，无任何函数注册、加载的相关条目；使用Postman测试端点时返回404 HTTP响应。

进一步测试发现，**所有本地开发的函数（包括新建的测试函数）**在JetBrains Rider、Visual Studio及命令行运行时均出现该问题，说明这是全局环境问题，而非单个项目问题。

已尝试的排查方向 #

• 项目类型错误
• 缺少函数触发器及相关配置问题
• 函数签名无效
• 缺失NuGet包
• local.settings.json配置错误
• host.json配置错误
• 运行配置问题
• 查看构建和运行的verbose日志寻找线索

环境信息 #

• Azure Functions Core Tools: 4.0.4915
• Function Runtime Version: 4.14.0.19631
• 框架：.NET 6.0
• 语言：C#

核心疑问 #

1. 该问题的成因是什么？如何解决？
2. 更新：排查发现func命令未从项目函数根目录读取host.json和local.settings.json，如何修正使其从项目目录读取配置？

一、修复func命令读取项目配置的问题 #

1. 切换终端工作目录到项目根目录

先进入包含host.json和local.settings.json的项目根文件夹，再执行运行命令：

cd /path/to/your/function-project
func start --verbose

2. 用参数指定项目工作目录

如果无法切换工作目录，可直接在命令中指定项目路径：

func start --working-directory /path/to/your/function-project --verbose

3. IDE中配置工作目录

• JetBrains Rider：编辑运行配置，找到「工作目录」选项，设置为项目根目录路径
• Visual Studio：右键项目 → 属性 → 调试 → 工作目录，设置为项目根目录

二、全局环境层面的排查与修复 #

若配置读取问题解决后仍无法加载函数，针对全局环境问题尝试以下步骤：

1. 清理Functions工具缓存

删除对应系统的缓存文件夹后重启func命令：

• Windows: %LOCALAPPDATA%\AzureFunctionsTools
• macOS/Linux: ~/.azurefunctions

2. 更新Azure Functions Core Tools到最新版本

当前使用的4.0.4915版本较旧，存在.NET 6兼容性问题，执行对应系统的更新命令：

# Windows（Chocolatey）
choco update azure-functions-core-tools-4
# macOS（Homebrew）
brew upgrade azure-functions-core-tools@4
# Debian/Ubuntu
apt-get update && apt-get install azure-functions-core-tools-4

3. 验证.NET 6运行环境

执行命令确认.NET 6 SDK和ASP.NET Core Runtime已正确安装：

dotnet --list-sdks
dotnet --list-runtimes

确保输出中存在6.x版本的对应组件。

4. 重置Functions工具全局配置

执行命令重置func工具的全局设置：

func settings reset

三、验证修复效果 #

修复后运行func start --verbose，若日志中出现类似以下条目，说明函数已成功加载，此时Postman测试端点即可正常访问：

Loading functions metadata
Found function(s): [YourFunctionName]
Host initialized (XXms)

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