将多个Python函数部署至同一Azure Function App的问题

一、Python Azure Functions的正确结构 #

Python版Azure Functions并非只能识别function_app.py，而是需要遵循以下规则：

• 所有函数可以集中写在function_app.py里，也可以拆分到多个文件，但必须保证函数被正确注册到同一个FunctionApp实例中。
• 拆分文件时，要么在function_app.py中导入其他文件的函数并添加装饰器，要么在其他文件中直接使用主文件的app实例定义函数。

示例结构：

# function_app.py
import azure.functions as func
from second_func import register_second_function

app = func.FunctionApp()

@app.function_name(name="CopyFromESB")
@app.service_bus_topic_trigger(...)  # 根据你的触发器类型配置
def copy_from_esb(msg: func.ServiceBusMessage):
    # 业务逻辑
    pass

# 注册第二个函数
register_second_function(app)

# second_func.py
import azure.functions as func

def register_second_function(app):
    @app.function_name(name="ReadFromESB")
    @app.service_bus_queue_trigger(...)
    def read_from_esb(msg: func.ServiceBusMessage):
        # 业务逻辑
        pass

二、关于function.json的作用（绝非仅适用于C#） #

function.json是所有语言的Azure Functions通用配置文件，作用是定义函数的触发器、绑定规则、输入输出参数等核心属性：

• Python v2模型中，这个文件会通过函数装饰器的配置自动生成，无需手动编写；
• 只有Python v1模型才需要手动创建function.json，但目前v1已逐步被淘汰，建议使用v2模型开发。

三、CLI发布的正确操作 #

使用func azure functionapp publish copy-read-from-esb命令时，不需要指定单个.py文件，它会自动发布整个项目目录下的所有相关文件（包括依赖的函数文件、requirements.txt、配置文件等）。

• 发布前先执行func start本地测试，确认两个函数都能被识别并正常触发；
• 确保项目目录结构规范，没有多余的层级或未被导入的孤立函数文件。

四、常见排查点 #

• 检查第二个函数的装饰器是否完整：必须包含@app.function_name和对应的触发器装饰器；
• 确认函数被正确注册到app实例中，未出现导入失败或作用域错误；
• 如果本地能识别两个函数但发布后Azure端看不到，检查发布时的CLI输出是否有报错，或在Azure门户的函数App控制台查看日志。

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