本文详解 flask 部署环境下安全、可靠地生成并展示动态图片的方法，解决因路径错误、权限不足或相对路径失效导致的 500 内部服务器错误。
本文详解 flask 部署环境下安全、可靠地生成并展示动态图片的方法，解决因路径错误、权限不足或相对路径失效导致的 500 内部服务器错误。
在 Flask 应用本地开发时，fig.savefig('static/myplot.png') 能正常工作，是因为当前工作目录通常就是项目根目录；但部署到生产环境（如 Gunicorn + Nginx、Heroku、AWS Elastic Beanstalk 或 PythonAnywhere）后，工作目录可能变化，且应用常以受限用户身份运行——此时相对路径会失效，写入 static/ 目录更可能因无写入权限或路径解析错误引发 Internal Server Error。
✅ 正确做法：使用绝对路径 + 权限校验
首先，获取项目根目录的绝对路径，确保 static 文件夹可写：
import os
from flask import Flask, request, render_template
from pathlib import Path
app = Flask(__name__)
# 获取项目根目录（假设 app.py 与 static/ 同级）
BASE_DIR = Path(__file__).parent.resolve()
@app.route("/plot", methods=['GET', 'POST'])
def plot():
if request.method == 'POST':
try:
xcord = int(request.form.get('xcord', 0))
ycord = int(request.form.get('ycord', 0))
goal = Goal(xcord, ycord)
percent = goal.is_goal()
fig = goal.shot_chart()
# ✅ 使用绝对路径保存图片
img_path = BASE_DIR / "static" / "myplot.png"
fig.savefig(img_path, pad_inches=0, dpi=300)
# ✅ 可选：验证文件是否成功写入（调试阶段强烈建议）
if not img_path.exists():
raise RuntimeError(f"Failed to save image to {img_path}")
return render_template(
"plot.html",
percent=percent,
xcord=xcord,
ycord=ycord
)
except Exception as e:
app.logger.error(f"Plot generation failed: {e}")
return render_template("error.html", message="图像生成失败，请检查输入或联系管理员"), 500
return render_template("plot.html") # GET 请求返回表单页? 模板中引用图片的规范写法
plot.html 中不要用 src="static/myplot.png" 这类硬编码路径。Flask 的 url_for() 函数会自动生成符合当前部署配置（含子路径、HTTPS 等）的安全 URL：
<h1>Shot Predictor</h1>
<h3>Enter the x and y coordinates of your shot and see the % chance of a goal!</h3>
<div>
<img src="{{ url_for('static', filename='myplot.png') }}"
class="soccer"
height="504" style="max-width:90%"
alt="Shot probability chart">
<table class="center">
<tr><td>Percent chance of a goal: {{ percent }}%</td></tr>
</table>
</div>⚠️ 注意事项：
- 禁止在生产环境开启
DEBUG=True（仅开发调试），但务必配置app.logger或使用logging捕获异常；- 确保部署服务器上
static/目录对运行 Flask 的用户（如www-data、heroku用户）具有写权限：chmod 755 static/ && touch static/test.txt && rm static/test.txt # 测试可写性- 若需支持多用户并发绘图，应为每次请求生成唯一文件名（如
myplot_{{ timestamp }}.png），避免覆盖冲突；- 更健壮的方案是不落地存储，改用
io.BytesIO将图像转为 base64 内嵌（适合小图）或存入对象存储（如 S3、MinIO）。
通过绝对路径 + url_for() + 显式错误处理，即可彻底规避部署时“图片无法保存/加载”的经典陷阱，让动态图表在生产环境稳定呈现。
