部署在IIS上的Flask应用报500错误，本地运行正常求解决

一、补全web.config的WSGI核心配置 #

你的现有web.config缺少IIS运行Flask必需的WSGI映射与路由重写配置，这是导致500错误的核心原因之一。修改web.config如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.web>
        <identity impersonate="false" />
        <customErrors mode="Off"/>
        <compilation debug="true"/>
    </system.web>
    <system.webServer>
        <handlers>
            <!-- 替换为你的Python实际路径 -->
            <add name="Python FastCGI" path="*" verb="*" modules="FastCgiModule" scriptProcessor="C:\Python39\python.exe|C:\Python39\Lib\site-packages\wfastcgi.py" resourceType="Unspecified" requireAccess="Script"/>
        </handlers>
        <rewrite>
            <rules>
                <rule name="Flask Routes" stopProcessing="true">
                    <match url=".*"/>
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true"/>
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true"/>
                    </conditions>
                    <action type="Rewrite" url="app.py"/>
                </rule>
            </rules>
        </rewrite>
        <httpErrors errorMode="Detailed"/>
    </system.webServer>
    <appSettings>
        <!-- app.app对应你的Flask实例：若app.py中是app = Flask(__name__)，则写app.app -->
        <add key="WSGI_HANDLER" value="app.app"/>
        <!-- 替换为你的Flask项目根目录 -->
        <add key="PYTHONPATH" value="C:\inetpub\wwwroot\your_flask_project"/>
        <!-- 替换为你的日志存储路径，需确保权限可写 -->
        <add key="WSGI_LOG" value="C:\inetpub\wwwroot\your_flask_project\flask_iis.log"/>
    </appSettings>
</configuration>

二、检查并配置权限 #

• 给Flask项目根目录添加IIS_IUSRS和IUSR用户的读取+写入权限（若应用需要生成日志、写入文件则必须配置）。
• 在IIS站点的「高级设置」中，将应用程序池标识改为LocalSystem（测试阶段使用，后续可切换为专用受限账户），避免进程权限不足。

三、查看详细错误定位根源 #

1. 打开配置中指定的flask_iis.log，日志会记录Flask抛出的具体异常（比如路由未匹配、JSON解析失败、依赖包缺失等）。
2. 在IIS管理器中，选中站点→「功能视图」→「错误页」，双击500错误项，设置为「详细错误」，直接在浏览器查看具体错误详情。

四、验证POST请求的兼容性 #

1. 确保Flask路由正确处理JSON请求，必须调用request.get_json()解析POST数据：

from flask import Flask, request

app = Flask(__name__)

@app.route('/app', methods=['POST'])
def handle_app():
    data = request.get_json()
    if not data:
        return "无效JSON数据", 400
    # 后续业务逻辑
    return "请求处理成功", 200

2. 检查IIS请求筛选：在站点的「请求筛选」→「HTTP动词」中，确认POST动词未被禁止。

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