我之前也碰到过这个坑，确实挺闹心的——明明代码有问题，终端却只给一个莫名其妙的TypeError，还得去浏览器里找真实错误。下面给你拆解原因和解决办法：

为什么会出现这个问题？ #

这个报错的核心原因是：你的代码里抛出了一个不合法的"异常"——也就是用raise语句抛出了一个不是继承自BaseException的对象（比如直接抛了字符串raise "something wrong"，或者自定义了一个没继承Exception的类然后抛出它）。

Flask的CLI默认会在后台加载你的应用，当它捕获到这个非法异常时，尝试重新抛出它，但因为这个对象不是标准异常类型，Python就会报错TypeError: exceptions must derive from BaseException，把真实的错误信息给完全掩盖了。

怎么让终端直接显示真实错误？ #

这里有几个实用的解决办法，按优先级来：

1. 直接用Python执行脚本，绕开Flask CLI #

别用flask run，直接跑你的应用脚本：

python example.py

这种方式下Python解释器会直接输出真实的错误，不会经过Flask CLI的后台加载逻辑，能最快定位到你代码里的非法异常。

2. 修复代码里的非法异常 #

检查你所有的raise语句，确保抛出的都是标准异常类的实例，或者自定义异常必须继承Exception：

• 错误示例：raise "数据库连接失败"
• 正确示例：raise Exception("数据库连接失败") 或者自定义异常：

  class DBConnectError(Exception):
      pass
  
  raise DBConnectError("数据库连接失败")
  

3. 关闭Flask CLI的后台加载（Flask 2.0+） #

如果你暂时找不到非法异常，可以在启动时加上--no-reload参数，让应用在前台加载：

FLASK_APP=example flask run --no-reload

这样真实的错误会直接输出到终端，不会被后台加载的异常处理逻辑覆盖。

4. 手动初始化应用并启动 #

修改你的应用脚本，加上直接启动的逻辑：

from flask import Flask

app = Flask(__name__)

# 你的路由和业务代码...

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

然后用python example.py启动，这种方式也能绕过Flask CLI的后台加载，直接显示真实错误。

附上你提供的报错堆栈：

$ FLASK_APP=example flask run
Traceback (most recent call last):
File "[...]/lib/python3.9/site-packages/flask/cli.py", line 356, in call
self._flush_bg_loading_exception()
File "[...]/lib/python3.9/site-packages/flask/cli.py", line 344, in _flush_bg_loading_exception
raise exc_info
TypeError: exceptions must derive from BaseException

内容的提问来源于stack exchange，提问作者Bryant MacMahon