如何排查Flask（Dash）中src端点的内部服务器500错误？

1. 强制输出详细错误日志到控制台 #

Dash基于Flask运行，默认debug模式可能未输出足够的错误细节。你可以手动配置Flask的日志系统，强制打印DEBUG级别的日志：

import logging
import dash

app = dash.Dash(__name__)
server = app.server  # 获取底层Flask实例

# 配置控制台日志输出
server.logger.setLevel(logging.DEBUG)
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.DEBUG)
server.logger.addHandler(console_handler)

# 启动应用
if __name__ == '__main__':
    app.run(host='0.0.0.0', debug=True)

重新启动后，再次触发音频请求，控制台会输出完整的错误栈，帮你定位具体问题（比如文件路径错误、权限不足、MIME类型不匹配等）。

2. 直接访问音频路径查看错误详情 #

跳过audio标签，直接在浏览器地址栏输入音频的完整URL（比如http://myserver:8050/assets/audio_data/xxx.mp3）。在debug模式下，Flask通常会返回带详细错误信息的页面，这比Chrome控制台的500提示更直观。

如果看不到错误页面，可手动添加一个测试路由排查：

@server.route('/test-audio')
def test_audio():
    from flask import send_from_directory
    import os
    audio_dir = os.path.join(server.root_path, 'assets', 'audio_data')
    return send_from_directory(audio_dir, '你的音频文件名.mp3')

访问http://myserver:8050/test-audio，就能看到具体的错误原因。

3. 检查assets目录规则与权限 #

• 确认audio_data是assets目录的直接子目录，Dash只会自动服务assets下的文件；
• 检查音频文件及目录的权限：服务器运行用户需要有读取文件的权限（Linux下可执行chmod -R 644 assets/audio_data/调整）；
• 手动指定MIME类型：部分音频格式可能被Flask识别错误，可自定义路由覆盖默认的assets服务：

@server.route('/assets/audio_data/<path:filename>')
def serve_audio(filename):
    from flask import send_from_directory, make_response
    response = make_response(send_from_directory('assets/audio_data', filename))
    # 根据文件后缀设置对应MIME类型
    if filename.endswith('.mp3'):
        response.headers['Content-Type'] = 'audio/mpeg'
    elif filename.endswith('.wav'):
        response.headers['Content-Type'] = 'audio/wav'
    elif filename.endswith('.ogg'):
        response.headers['Content-Type'] = 'audio/ogg'
    return response

4. 配置日志文件持久化 #

默认情况下Dash/Flask不会生成日志文件，你可以手动添加文件日志处理器，把错误日志保存到本地：

file_handler = logging.FileHandler('app_debug.log')
file_handler.setLevel(logging.DEBUG)
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)
server.logger.addHandler(file_handler)

日志会写入当前目录下的app_debug.log，方便后续回溯问题。

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