Functions Framework本地部署Flask API后GET请求返回404问题咨询

1. 适配Cloud Functions的Flask路由与入口函数 #

直接运行Flask正常，但用functions-framework部署后404，核心问题通常是WSGI适配或路由匹配错误：

• 确保你的入口函数run_app正确将Cloud Functions的请求转交给Flask应用，示例代码如下：

  from flask import Flask, request
  
  app = Flask(__name__)
  
  # 确认路由路径与请求地址匹配，这里是根路径/
  @app.route('/', methods=['GET'])
  def get_user_profile():
      user_id = request.args.get('userId')
      # 你的业务逻辑代码
      return {"status": "success", "userId": user_id}
  
  # Cloud Functions的入口函数，必须接受request参数
  def run_app(request):
      # 适配WSGI接口，把Cloud Functions请求传给Flask
      return app(request.environ, lambda status, headers: None)
  

• 如果你的Flask路由不是根路径（比如/user-profile），测试时请求地址要改为http://localhost:8080/user-profile?userId=11112022，而非根路径。

2. 验证functions-framework启动参数 #

确认启动命令的--target=run_app与代码中定义的入口函数名完全一致，大小写、拼写不能错。启动时打开--debug模式，查看控制台日志：

• 如果日志显示GET / 404，说明请求已到达，但Flask无匹配路由；
• 如果连请求记录都没有，检查端口8080是否被占用，或函数启动是否报错。

3. 解决curl未找到的问题 #

Windows系统默认未预装curl，直接用Postman、浏览器访问http://localhost:8080/?userId=11112022测试即可，也可单独安装curl并添加到系统环境变量。

4. 排查硬编码路径/端口问题 #

检查代码中是否存在硬编码的本地端口（如5000）或绝对URL，这类代码在functions-framework环境下会失效，需全部改为相对路径或动态获取请求信息。

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