问题背景
很多网站在迁移或部署过程中会遇到这样的情况：服务器上明明存在 .shtml 文件，浏览器访问却提示 404 或 500 错误。即使已经在 IIS 中添加了 .shtml 的 MIME 类型，问题依然存在。这是因为 .shtml 属于动态内容，需要由 IIS 的服务器端包含模块来处理，仅仅添加 MIME 类型只是告诉 IIS 允许传输这个文件，并没有告诉 IIS 由谁来解析它。
第一步：安装服务器端包含功能（一般无需安装，服务器已自带）
打开服务器管理器，点击添加角色和功能，一路下一步进入服务器角色页面，依次展开 Web 服务器、Web 服务器、应用程序开发，勾选服务器端包含，然后完成安装。
安装完成后，IIS 中就具备了处理 .shtml 文件的能力。
第二步：添加模块映射
打开 IIS 管理器，点击需要处理的站点名称，在中间功能视图中双击处理程序映射。
在右侧操作栏中点击添加模块映射，在弹出的窗口中填写以下信息：
请求路径填写星号点 shtml，也就是 *.shtml。
模块从下拉菜单中选择 ServerSideIncludeModule。
名称填写 SSINC-shtml，或者任意便于识别的名称。
可执行文件一栏留空，不要填写任何内容。
填写完成后点击确定保存。
这里要特别强调，一定要选择添加模块映射，而不是添加托管处理程序。添加托管处理程序是专门给 .NET 代码模块使用的，ServerSideIncludeModule 属于 IIS 的原生模块，用托管处理程序的方式添加会导致请求处理管道混乱，最终出现 500 错误，并且还会和 PHP 等其他映射产生冲突。而添加模块映射是添加原生模块的正确方式，不会干扰其他配置。
可执行文件留空也是关键。SSI 是 IIS 自带的原生模块，不需要指定外部 DLL 路径。只有使用添加脚本映射时，才需要手动填写 ssinc.dll 的路径，但那种方式相对容易出错，不推荐。
第三步：重启 IIS（一般无需重启立即生效）
完成配置后，在命令行中运行 iisreset，或者在 IIS 管理器中重启站点，让配置生效。
重要提醒
在整个操作过程中，不要点击恢复为父级。恢复为父级会清除站点上所有自定义的处理程序映射，让它继承服务器的全局配置。虽然这个操作有时能解决 .shtml 的冲突，但代价是会把 PHP 等其他配置一并重置，导致网站后台无法访问。正确的做法是只针对 .shtml 这一条映射单独处理，不要整体重置。
如果之前已经误将 .shtml 配置为静态文件处理，或者存在冲突的映射，只需要在处理程序映射列表中找到 .shtml 对应的条目，选中并删除，然后用添加模块映射的方式重新添加一次即可。
验证配置
在网站根目录创建一个 test.shtml 文件，内容写入一行 SSI 指令，用来输出服务器本地时间。保存后，用浏览器访问这个文件，如果页面显示了当前日期和时间，说明 SSI 配置成功。
同时也要测试一下网站后台的 PHP 页面是否能正常打开，确认 .shtml 和 .php 两者互不干扰，都能正常工作。
常见问题排查
如果访问 .shtml 仍然报错，可以检查文件本身是否被设置为隐藏属性，IIS 对于隐藏文件会返回 404 错误。还要确认文件确实存在于对应的物理路径下，以及 IIS 应用程序池对该目录有读取权限。
如果页面显示的是 SSI 指令原文而不是解析结果，说明 SSI 没有生效，需要回到处理程序映射中确认 .shtml 是否正确指向了 ServerSideIncludeModule。
如果出现 Error processing SSI file 的提示，通常是被包含的文件路径错误，或者 IIS 对目标文件没有读取权限，检查 include 指令中的路径和文件权限即可。
总结
让 IIS 支持 .shtml 文件访问，核心就是三步：安装服务器端包含功能，用添加模块映射的方式将 *.shtml 指向 ServerSideIncludeModule 并且可执行文件留空，最后重启 IIS。记住不要用添加托管处理程序，也不要轻易点恢复为父级，这样 .shtml 和 .php 就能各自正常工作，互不冲突。
免责声明
本教程仅为技术经验分享，供学习和参考使用。服务器环境配置因系统版本、IIS 版本、已有配置、第三方软件等因素千差万别，实际操作中可能存在不可预见的风险和变数。请务必在充分理解原理、确认自身环境、并提前做好数据和配置备份的前提下谨慎操作。因参照本教程进行任何操作而直接或间接导致的网站无法访问、配置丢失、数据损坏、业务中断或其他任何后果，均由操作者本人完全承担，教程作者不承担任何责任。如对操作存有疑虑，建议先在测试环境中验证，或寻求专业运维人员协助。
本网声明：媒塔CMS V3.0发布此文仅出于信息分享，并非赞同其观点或证实其描述，不承担侵权行为的连带责任。文章内容仅供参考，不构成投资建议。投资者据此操作，风险自担。版权归原作者所有，如涉版权或来源标注有误，请联系我们删除。本网原创内容未经书面授权，任何单位或个人不得转载和摘编。
