Python Flask实现图片上传接口及可访问URL生成

Nora

发布时间：2026-10-13 | 3人浏览过

原创

本文介绍如何使用Python Flask框架开发一个支持图片上传的Web接口。通过定义上传路由和静态文件访问路由，实现将用户上传的图片保存至服务器指定目录，并生成可直接通过URL访问的图片链接。文章包含完整的项目结构、核心代码示例及本地测试步骤，适用于需要实现文件存储与展示功能的Python Web应用开发场景。

开发环境与功能概述

开发环境版本为Python 3.7。

主要功能目标是构建一个用户可访问的Web页面，该页面支持图片上传功能，并将接收到的图片文件安全地保存在服务器端。

项目的基础目录结构如下所示。

后端接口实现代码

核心后端逻辑文件app.py的具体代码如下。


from flask import Flask, Response, request, render_template
from werkzeug.utils import secure_filename
import os
 
app = Flask(__name__)
 
 
# 设置图片保存文件夹
UPLOAD_FOLDER = 'photo'
app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER
 
# 设置允许上传的文件格式
ALLOW_EXTENSIONS = ['png', 'jpg', 'jpeg']
 
 
# 判断文件后缀是否在列表中
def allowed_file(filename):
  return '.' in filename and filename.rsplit('.', 1)[-1] in ALLOW_EXTENSIONS
 
 
# 上传图片
@app.route("/photo/upload", methods=['POST', "GET"])
def uploads():
  if request.method == 'POST':
    # 获取post过来的文件名称，从name=file参数中获取
    file = request.files['file']
    if file and allowed_file(file.filename):
      print(file.filename)
      # secure_filename方法会去掉文件名中的中文
      file_name = secure_filename(file.filename)
      # 保存图片
      file.save(os.path.join(app.config['UPLOAD_FOLDER'], file_name))
      return "success"
    else:
      return "格式错误，请上传jpg格式文件"
  return render_template('index.html')
 
 
# 查看图片
@app.route("/photo/<imageId>.jpg")
def get_frame(imageId):
  # 图片上传保存的路径
  with open(r'C:/Users/Administration/Desktop/photo_ceshi/photo/{}.jpg'.format(imageId), 'rb') as f:
    image = f.read()
    resp = Response(image, mimetype="image/jpg")
    return resp
 
 
if __name__ == "__main__":
  app.run(host='0.0.0.0', port=5000, debug=True)

前端上传页面代码

前端交互页面index.html的代码内容如下。


<!DOCTYPE html>
<html lang="zh-cmn-Hans">
<head>
  <meta charset="UTF-8">
  <title>Upload</title>
</head>
<h1>请上传图片文件</h1>
<form action="" method=post enctype=multipart/form-data>
<p><input type=file name=file>
<input type=submit value=Upload>
</form>