Lucee环境下自定义友好URL出现404错误，排查IIS配置遗漏问题

嘿，我来帮你梳理下可能遗漏的IIS配置细节，毕竟自定义友好URL搭配404跳转的场景里，很容易有隐藏的配置坑：

• 务必检查URL重写模块的规则是否到位
  自定义友好URL的核心是让IIS把漂亮的URL（比如/product/123）转发到实际的Lucee处理模板（比如/index.cfm?productId=123）。如果没配置对应的重写规则，IIS根本不知道该把请求交给哪个Lucee文件，直接就会触发404——哪怕你设置了404跳转页也没用。要确保规则的匹配模式、操作类型（转发）以及目标URL都配置正确，而且规则是启用状态。

• 仔细核对IIS错误页的设置细节

  • 你设置的404执行路径是本地URL还是物理文件路径？如果选本地URL，要保证路径是站点根相对路径（比如/404-handler.cfm），并且一定要选择*“执行URL而不是重定向”*选项——要是选了重定向，会返回302状态码，不是真正的友好404处理。
  • 另外，要确认这个404设置是否覆盖了所有请求类型。有些情况下，默认设置只针对静态文件的404，动态请求（比如.cfm文件）可能没被包含进去，你可以在错误页设置里点击“编辑功能设置”，选择“详细错误”或者“自定义错误页”时确保覆盖所有内容。

• 确认Lucee与IIS的404处理优先级
  Lucee的“缺失模板”设置是在Lucee层面处理找不到的.cfm文件，但如果IIS在Lucee之前就拦截了404请求，Lucee的配置就不会生效。你需要确保：要么IIS把404请求转发给Lucee的处理页面（比如你的自定义404.cfm），要么调整IIS的错误页处理顺序，让Lucee先处理动态请求的404。

• 检查请求筛选是否拦截了友好URL
  IIS的“请求筛选”功能可能会阻止某些不符合规则的URL，比如没有扩展名的友好URL（因为默认可能只允许列出的扩展名），或者包含特殊字符的路径。你可以在IIS管理器的“请求筛选”中，检查“文件扩展名”选项卡是否开启了*“允许未列出的文件扩展名”*，同时确认没有URL规则拦截你的友好URL模式。

• 验证默认文档设置
  如果你的友好URL是指向站点根目录的默认页面（比如依赖index.cfm作为入口），要确保IIS的“默认文档”列表里包含了index.cfm，并且优先级足够高——不然IIS找不到默认入口，也会直接返回404。

• 多场景测试验证
  别只测一种情况，建议分别测试：

  • 访问不存在的静态文件（比如/test.png），看是否触发自定义404
  • 访问不存在的Lucee模板（比如/no-such-page.cfm），看是否触发Lucee的404处理
  • 访问格式正确但内容不存在的友好URL（比如/product/9999），看是否能被正确转发到处理页面

内容的提问来源于stack exchange，提问作者K.Krishna Raju