如何解决IIS托管多页面Dash应用时报内部服务器错误的问题？

1. 入口文件配置修正 #

多页应用的核心问题是IIS的wfastcgi模块需要直接识别到全局暴露的WSGI应用对象，你无需调整Dash官方要求的项目架构，按以下规则配置即可：

• 如果Flask实例定义在独立脚本中，直接在项目根目录的入口脚本（一般命名为wsgi.py或者app.py）中导入该实例即可，无需修改原有结构。
• 入口脚本必须显式开启多页模式，绑定Flask实例，示例代码如下：

from flask import Flask
import dash
from dash import Dash, html, dcc

# 若Flask实例在其他脚本，替换为 from 你的脚本名 import server
server = Flask(__name__)

app = Dash(
    __name__,
    server=server,
    use_pages=True,
    suppress_callback_exceptions=True,
    pages_folder="pages" # 对应官方要求的多页页面存放目录
)

# 根布局必须包含dcc.Location和dash.page_container，无需手动写路由回调
app.layout = html.Div([
    dcc.Location(id="url"),
    # 此处可自定义导航栏等全局组件
    dash.page_container
])

if __name__ == "__main__":
    app.run_server(host="0.0.0.0", port=84)

2. IIS站点配置调整 #

确认你已在对应Python环境安装wfastcgi并执行wfastcgi-enable完成模块注册后，按以下要求配置站点：

• 站点物理路径指向项目根目录，即包含入口脚本、pages文件夹的上层目录
• 处理程序映射的请求限制中，可执行文件路径填写入口脚本的绝对路径，例如C:\inetpub\dash_app\wsgi.py
• 在站点的「应用程序设置」中添加两个必填变量：
  • 键为WSGI_HANDLER，值为入口脚本名.实例名，如果入口脚本叫wsgi.py，导出的Flask实例叫server，就填wsgi.server
  • 键为PYTHONPATH，值为项目根目录的绝对路径，例如C:\inetpub\dash_app，确保Python可以识别pages目录下的页面模块
• 给项目根目录添加IIS_IUSRS用户的读取、执行权限，避免权限不足引发的报错

3. 错误排查方案 #

如果仍返回内部错误，可以在入口脚本开头添加以下代码输出调试日志：

import sys
import logging
logging.basicConfig(stream=sys.stderr, level=logging.DEBUG)

查看IIS站点日志或者Python错误输出即可定位具体问题，绝大多数报错都是PYTHONPATH配置错误导致模块找不到，或者WSGI_HANDLER的变量名拼写错误。

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