Azure Functions Python v2依赖注入配置及启动位置咨询

核心问题分析 #

Azure Functions Python v2 没有官方提供类似.NET FunctionStartup的初始化机制，且你遇到的Kink报错本质是DI容器初始化时机晚于函数装饰器执行（导入蓝图时@inject已触发，但容器未注册依赖），同时日志顺序异常源于print输出缓冲与模块加载顺序问题。

1. 调整启动代码执行顺序 #

必须确保DI容器初始化在导入函数蓝图之前完成，避免装饰器执行时容器为空。

修改function_app.py：

import azure.functions as func
import logging
from bootstrap import start_up

# 优先初始化DI容器
logging.info("Initializing DI container...")
start_up()
logging.info("DI container initialized successfully.")

# 容器就绪后再导入蓝图
from http_blueprint import bp

app = func.FunctionApp()
app.register_functions(bp)

2. 正确注册依赖到Kink容器 #

在bootstrap.py中完成依赖的注册（单例或工厂模式按需选择）：

from kink import container
from IocService import IocService

def start_up():
    # 注册单例实例（全局复用）
    container.register(IocService, instance=IocService(message="Hello from DI"))
    
    # 若需每次请求创建新实例，改用工厂方法：
    # container.register(IocService, factory=lambda: IocService(message="Hello from DI"))

3. 修正函数装饰器与注入逻辑 #

调整装饰器顺序（@bp.route作为最外层，确保Azure识别触发器；@inject负责依赖注入），并正确使用注入的服务：

from kink import inject
import logging
from IocService import IocService
import azure.functions as func

bp = func.Blueprint()

@bp.route(route="default_template")
@inject
def default_template(req: func.HttpRequest, context: func.Context, service: IocService) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')
    
    # 使用注入的服务实例
    greeting = service.say_hello("test")
    logging.info(greeting)

    name = req.params.get('name')
    if not name:
        try:
            req_body = req.get_json()
        except ValueError:
            pass
        else:
            name = req_body.get('name')

    if name:
        return func.HttpResponse(
            f"{service.say_hello(name)} This HTTP-triggered function executed successfully.")
    else:
        return func.HttpResponse(
            "This HTTP-triggered function executed successfully. "
            "Pass a name in the query string or in the request body for a personalized response.",
            status_code=200
        )

4. 解决日志顺序异常问题 #

• 替换所有print语句为logging模块，Azure Functions日志系统会统一处理输出顺序，避免缓冲导致的顺序错乱：

  # 原 print("before start up") 替换为
  logging.info("before start up")
  

• 避免在函数模块顶层执行日志输出，确保初始化日志优先于函数执行日志输出。

关键注意事项 #

• Azure Functions Python v2无官方初始化钩子，必须通过调整导入顺序保证DI容器在函数加载前就绪。
• Kink的@inject装饰器依赖已注册的容器，因此必须先完成依赖注册再导入包含装饰函数的蓝图。
• 装饰器顺序不可颠倒：@bp.route作为最外层，确保Azure能正确识别函数为触发器；@inject在其下方处理依赖注入。

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