浏览器缓存了旧路由或重定向信息，导致 flask 新启动的应用无法正确响应请求；清除浏览器缓存和 cookies 后即可恢复正常访问。
浏览器缓存了旧路由或重定向信息，导致 flask 新启动的应用无法正确响应请求；清除浏览器缓存和 cookies 后即可恢复正常访问。
当你在新电脑上克隆并运行一个原本在旧设备上正常工作的 Flask 项目，却突然遇到 “The requested URL was not found on the server”（404 错误），而代码本身未改动、路由定义完整、app.run() 也成功启动——这往往并非后端逻辑问题，而是前端缓存干扰所致。
? 根本原因分析
Flask 默认不强制禁用浏览器缓存，尤其在开发阶段频繁重启服务时，浏览器可能：
- 缓存了旧的 302 重定向（例如登录跳转 login_view = 'login' 触发的跳转）；
- 保存了已失效的会话 Cookie（如 session 或 Flask-Login 的 _user_id）；
- 预加载了已被删除或重命名的静态资源路径（如 /static/css/main.css），间接影响路由匹配逻辑（极少数情况）。
你提供的代码中存在一个关键线索：login_manager.login_view = 'login'，且使用了 @login_required 装饰器。若用户此前已登录，其浏览器可能仍携带有效但服务端无法识别的 session（因 secret_key 虽一致，但新环境的 session 存储机制/签名上下文可能存在细微差异），导致 Flask-Login 尝试重定向到 /login，而该路由尚未在代码片段中定义 —— 这正是 404 的直接诱因。
✅ 验证方式：在无痕模式（Incognito）中访问 http://127.0.0.1:5000/。若首页正常显示，即可确认是缓存/cookie 导致的问题。
?️ 推荐解决方案
1. 清除浏览器缓存与 Cookies（最快见效）
- Chrome / Edge / Firefox：快捷键 Ctrl+Shift+Del → 勾选 Cookies 和 Cached images and files → 时间范围选 All time → 确认清除。
- 重启浏览器后重新访问 http://127.0.0.1:5000/。
2. 开发阶段增强健壮性（预防复发）
在 app.py 顶部添加以下配置，强制禁用模板和静态文件缓存（仅限开发环境）：
# 开发环境禁用缓存（部署时请移除或改为条件启用）
if app.debug:
app.config['SEND_FILE_MAX_AGE_DEFAULT'] = 0
app.jinja_env.cache = {}
同时，确保 login 路由真实存在（你的代码中缺失该路由，需补充）：
@app.route('/login', methods=['GET', 'POST'])
def login():
if request.method == 'POST':
email = request.form.get('email')
password = request.form.get('password')
user = Users.query.filter_by(email=email).first()
if user and pswd_controller.check_password_hash(user.password, password):
login_user(user)
return redirect(url_for('homepage'))
else:
flash('Invalid credentials', 'error')
return render_template('login.html') # 确保存在此模板
3. 其他排查要点（辅助验证）
- ✅ 检查终端日志：启动 Flask 时是否输出 * Running on http://127.0.0.1:5000？有无 WARNING: This is a development server. 提示？
- ✅ 确认所有路由均已正确定义：使用 flask routes 命令（需安装 Flask CLI）列出全部注册路由；
- ✅ 验证数据库初始化：with app.app_context(): db.create_all() 已执行，且 product_info.db 文件存在于项目根目录；
- ⚠️ 注意路径硬编码风险：如 product_image_path 中的 C:/Users/User1/... 在新电脑上必然失效，应改用 os.path.join(app.static_folder, 'Images', 'Product Images')。
✅ 总结
“URL Not Found” 在迁移 Flask 项目时高频出现，但多数情况下与代码无关，而是浏览器缓存、缺失关键路由（如 /login）、或静态路径硬编码导致。优先清除缓存 + 补全基础路由 + 使用相对路径，三步即可解决 90% 的同类问题。开发中养成使用无痕窗口测试的习惯，能显著减少此类干扰。
