Flask部署机器学习模型时HTML页面无输出问题求助

可能的问题原因及对应解决建议 #

1. 路由定义存在语法错误 #

你的@app.route ("/predict")中，route和括号之间多了一个空格，这会导致Flask无法正确识别该路由规则，表单提交后找不到对应的处理函数，返回404错误。

解决方法：
删除route和括号之间的空格，修正为：

@app.route("/predict", methods=['POST'])

2. 模型加载路径或文件异常 #

你使用了绝对路径加载模型，但Windows路径中的空格、权限问题，或者模型文件损坏都可能导致模型加载失败，后续预测步骤无法执行。

解决方法：

• 优先使用相对路径：将model.pkl放在Flask项目的根目录下，修改加载代码为：

  model = pickle.load(open("model.pkl", "rb"))
  

• 检查模型文件是否完整：可以单独写一个测试脚本验证模型能否正常加载并预测：

  import pickle
  import numpy as np
  model = pickle.load(open("model.pkl", "rb"))
  # 测试预测
  print(model.predict(np.array([5.1, 3.5, 1.4, 0.2]).reshape(1,4)))
  

3. 缺失异常处理，输入错误导致崩溃 #

如果用户输入的不是合法数字（比如空格、字母），float(request.form.get(...))会抛出ValueError，导致Flask返回500内部错误，页面无输出。

解决方法：
添加异常捕获逻辑，同时给用户返回友好提示：

@app.route("/predict", methods=['POST'])
def Predict_species():
    try:
        spl = float(request.form.get('sepal length (cm)'))
        spw = float(request.form.get('sepal width (cm)'))
        ptl = float(request.form.get('petal length (cm)'))
        ptw = float(request.form.get('petal width (cm)'))

        output = model.predict(np.array([spl, spw, ptl, ptw]).reshape(1,4))
        # 如果是分类模型，映射为具体类别名称（比如鸢尾花的三个类别）
        species_map = {0: 'Setosa', 1: 'Versicolor', 2: 'Virginica'}
        result = species_map.get(output[0], "Unknown Species")
        return render_template("index.html", prediction=result)
    except ValueError:
        return render_template("index.html", prediction="请输入有效的数字！")

4. 返回内容未嵌入原页面，用户感知不到 #

当前代码直接返回str(Output)，会跳转到一个空白页面显示类似[0]的内容，用户可能误以为没有输出。

解决方法：
修改返回逻辑，将预测结果传递回原模板，在页面上显示：

• 修改index.html，添加显示预测结果的区域：

  <!DOCTYPE html>
  <html lang="en">
  <head>
      <meta charset="UTF-8">
      <title>Flower Species Predictor</title>
  </head>
  <body>
      <h1>Flower Species Predictor</h1>
      <!-- 显示预测结果 -->
      {% if prediction %}
          <h3>预测结果：{{ prediction }}</h3>
      {% endif %}
      <form action="/predict" method="POST">
          <label>sepal length (cm)</label><br>
          <input type="text" name="sepal length (cm)"><br><br>
  
          <label>sepal width (cm)</label><br>
          <input type="text" name="sepal width (cm)"><br><br>
  
          <label>petal length (cm)</label><br>
          <input type="text" name="petal length (cm)"><br><br>
  
          <label>petal width (cm)</label><br>
          <input type="text" name="petal width (cm)"><br><br>
  
          <input type="submit" value="Predict"><br><br>
      </form>
  </body>
  </html>
  

• 同时修改app.py的返回逻辑，如上面异常处理中的代码，使用render_template传递prediction参数。

5. Flask运行模式问题 #

如果没有开启调试模式，错误信息不会显示在页面上，难以排查问题。

解决方法：
在app.py末尾添加：

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

开启调试模式后，遇到错误会在页面上显示详细的报错信息，方便定位问题。

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