如何为Python Flask创建的API传递参数？能否部署至Heroku？

阿华AIGC实验室

2026-5-29

Flask 接收查询参数 & Heroku 部署指南

一、Flask 中如何实现类似 R Plumber 的参数传递

刚从 R Plumber 转 Flask 确实会有小适应期——Plumber 能直接把 URL 查询参数绑定到函数参数上，但 Flask 需要通过 request 对象来获取这些参数。我给你写个完全贴合你需求的示例：

首先确保安装了 Flask：

pip install flask

然后写你的 API 代码（保存为 app.py）：

from flask import Flask, request, jsonify
import pandas as pd

app = Flask(__name__)

# 假设你的 CSV 文件和 app.py 在同一目录下
CSV_FILE_PATH = "your_data.csv"

@app.route('/', methods=['GET'])
def calculate():
    # 获取 URL 里的查询参数 a 和 b，自动转成数值类型，没传的话返回 None
    a = request.args.get('a', type=float)
    b = request.args.get('b', type=float)
    
    # 检查参数是否齐全
    if a is None or b is None:
        return jsonify({"error": "请传递参数 a 和 b，比如 /?a=2&b=3"}), 400
    
    # 读取 CSV 并执行你的计算逻辑（这里替换成你实际的计算代码）
    df = pd.read_csv(CSV_FILE_PATH)
    # 举个简单计算例子，你可以改成自己的逻辑
    result = (df['target_column'].mean() * a) + b
    
    # 返回计算结果
    return jsonify({"result": result})

if __name__ == '__main__':
    app.run(debug=True)

测试的时候直接访问 http://localhost:5000/?a=2&b=5 就能拿到结果啦！核心就是用 request.args.get() 来抓取 URL 里的查询参数，type=float 还能帮你自动把字符串转成数值，避免后续计算出错。

二、这类 API 完全可以部署到 Heroku

Heroku 对 Flask 应用的支持非常友好，流程也不复杂，给你列个核心步骤：

创建必要配置文件
- 新建 requirements.txt，写入依赖：
```
flask
pandas
gunicorn
```
  （gunicorn 是生产环境的服务器，Heroku 推荐用它来运行 Flask 应用）
- 新建 Procfile（首字母大写，无后缀），写入：
```
web: gunicorn app:app
```
  这里的 app:app 指的是你的 Python 文件是 app.py，里面的 Flask 实例叫 app。
处理 CSV 文件
把你的 CSV 文件放在项目根目录，和 app.py 同层级，部署时会一起上传到 Heroku。如果你的 CSV 需要频繁更新，可能得用云存储（比如 S3），但如果是静态文件，直接放项目里就没问题。
部署到 Heroku
- 先安装 Heroku CLI，登录你的 Heroku 账号。
- 把项目初始化为 Git 仓库（如果还没弄）：
```
git init
git add .
git commit -m "Initial commit"
```
- 创建 Heroku 应用：
```
heroku create your-app-name
```
- 推送代码到 Heroku：
```
git push heroku main
```
- 打开线上应用：
```
heroku open
```