MacOS M1环境下Java Azure函数本地运行异常求助

• 确认Azure Functions Core Tools的arm64兼容性
  旧版本的Core Tools在M1（arm64）架构上对Java函数的识别存在问题，卸载现有版本后安装适配arm64的最新稳定版。通过Homebrew执行brew install azure-functions-core-tools@4（优先选v4版本），安装完成后执行func --version确认版本号。

• 检查JDK架构与版本匹配
  确保使用的JDK11是arm64原生版本，不要用x86架构的JDK（Rosetta模拟运行的版本会导致函数识别异常）。执行java -version查看输出，确认包含aarch64或arm64标识。推荐使用Azul Zulu或OpenJDK的arm64版本。

• 升级Azure Functions Maven插件版本
  在项目的pom.xml中，将azure-functions-maven-plugin的版本更新到最新稳定版（比如4.3.0及以上），插件版本过低会导致arm64环境下的函数扫描失败。更新后执行mvn clean清理缓存。

• 验证函数类编译与路径
  执行mvn package后，检查target/azure-functions/<你的函数应用名称>/目录下是否存在编译后的函数类文件（比如HttpTriggerJava.class）。如果不存在，说明编译过程有问题，检查pom.xml中的build配置，确保函数类所在的包被正确纳入编译范围。

• 清理缓存后重新运行
  执行完整的清理-打包-运行命令：mvn clean package azure-functions:run，避免旧的编译产物或缓存干扰函数扫描。

• 检查注解的正确性
  确保函数类上的@FunctionName注解导入的是com.microsoft.azure.functions.annotation.FunctionName，不要误导入其他包下的同名注解。

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