在IIS上用wfastcgi部署Flask+Plotly/Dash的路由配置问题求助

问题回顾 #

你已经在IIS里配置好Python和wfastcgi，基础Flask应用能正常运行，但换成带属性路由的Dash应用后，不知道web.config里的WSGI_HANDLER该如何设置，尝试设为index.display_page时还出现了参数不匹配的错误：

TypeError: display_page() takes 1 positional argument but 2 were given

错误原因解析 #

这个报错逻辑很明确：你把Dash的路由回调函数display_page当成了WSGI入口，但WSGI规范要求handler函数必须接收environ和start_response两个参数，而display_page是Dash专门用来处理路径跳转的回调，只认pathname这一个参数，参数数量完全不匹配，自然会触发错误。

正确配置步骤 #

1. 调整Dash应用代码，暴露合规的WSGI入口 #

Dash是基于Flask开发的，每个Dash实例都自带一个server属性——这就是底层符合WSGI规范的Flask应用对象。你需要在主文件（比如index.py）里把这个对象明确暴露出来：

修改后的index.py示例：

from dash.dependencies import Input, Output
import dash_core_components as dcc
import dash_html_components as html
from app import app  # 这里的app是你的Dash实例

app.layout = html.Div([
    dcc.Location(id='url', refresh=False),
    html.Div(id='page-content')
])

@app.callback(Output('page-content', 'children'), [Input('url', 'pathname')])
def display_page(pathname):
    if pathname == '/apps/web_example_a':
        from apps import web_example_a
        return web_example_a.layout
    # 可在此添加更多路由分支
    else:
        return '404'

# 关键：将Dash的Flask server作为WSGI入口暴露
wsgi_app = app.server

if __name__ == '__main__':
    app.run_server(debug=True)

2. 修改web.config中的WSGI_HANDLER配置 #

把appSettings节点下的WSGI_HANDLER值改为index.wsgi_app，指向刚才暴露的合规WSGI入口：

<add key="WSGI_HANDLER" value="index.wsgi_app" />

3. 额外检查项 #

• 确认PYTHONPATH配置完整，必须包含虚拟环境的site-packages路径，否则会出现依赖包找不到的问题
• 关于Plotly的警告：这是因为IIS应用池对应的用户没有读写你个人目录（~/.plotly）的权限，不影响应用核心功能；若要消除警告，给应用池用户分配对应目录的读写权限即可

按以上步骤配置后，你的Dash应用就能在IIS环境下正常处理属性路由了。

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