0

0

解决IIS Rewrite规则导致样式表加载失败的问题

碧海醫心

碧海醫心

发布时间:2025-11-12 12:14:01

|

833人浏览过

|

来源于php中文网

原创

解决IIS Rewrite规则导致样式表加载失败的问题

本文详细探讨了在iis中使用url rewrite规则时,可能导致网站静态资源(如css、图片)加载失败的问题。通过分析重定向规则对相对路径的影响,并提供利用浏览器开发者工具诊断问题的方法,文章给出了两种主要解决方案:调整静态资源路径为根相对路径,以及在rewrite规则中明确排除静态资源,确保网站在应用重写规则后仍能正常显示。

引言:IIS URL Rewrite与静态资源加载问题

在IIS(Internet Information Services)环境中部署Web应用程序时,URL Rewrite模块是一个非常强大的工具,它允许我们对传入的URL进行修改、重写或重定向,以实现友好的URL、SEO优化、安全增强等目的。然而,不当的Rewrite规则配置有时会带来意想不到的副作用,其中最常见的问题之一就是导致网站的样式表(CSS)、图片、JavaScript文件等静态资源无法正常加载,从而使页面显示混乱或功能异常。

当开发者在web.config文件中添加了规则,特别是全局性的重定向规则后,页面可能会突然失去所有样式,只剩下纯文本内容。这通常表明浏览器未能成功获取到CSS文件。

问题根源分析:Rewrite规则的副作用

问题的核心在于URL Rewrite规则如何处理对静态资源的请求。在上述场景中,用户添加了一个将所有请求重定向到网站根目录的规则:


    
    

这条规则的含义是:匹配所有URL(url="."),然后执行一个301或302重定向(action type="Redirect"),将用户重定向到当前主机名的根URL(https://{HTTP_HOST})。

当浏览器请求一个HTML页面(例如web.test.com/something)时,IIS会根据这条规则将其重定向到https://web.test.com。页面加载后,HTML文件中的静态资源引用(如)是相对路径。浏览器在解析这些相对路径时,会基于当前页面的URL(即https://web.test.com)来构建完整请求路径。因此,它会尝试请求https://web.test.com/css/style.css。

然而,如果这条全局重定向规则仍然生效,那么对https://web.test.com/css/style.css的请求也会被这条规则捕获,并再次重定向到https://web.test.com。这就形成了一个死循环,或者更常见的是,浏览器根本无法获取到style.css文件,因为它被重定向到了一个HTML页面,而不是CSS文件本身。最终,浏览器会报告404(未找到)错误或重定向循环错误,导致样式加载失败。

用户尝试添加的标签主要用于配置特定路径的授权或其他system.web设置,它们与URL重写/重定向导致的资源路径问题无关,因此无法解决此类问题。

诊断步骤:利用浏览器开发者工具

要准确诊断此类问题,浏览器开发者工具是不可或缺的。

  1. 打开开发者工具: 在浏览器中访问出现问题的页面,然后按下F12键(或右键点击页面选择“检查”)。
  2. 切换到“网络”(Network)标签页: 这个标签页会显示浏览器加载页面时发出的所有HTTP请求及其响应。
  3. 刷新页面: 清空网络日志后,重新加载页面,观察请求列表。
  4. 查找失败的请求:
    • 筛选出“CSS”、“Img”或“All”类型的请求。
    • 重点关注HTTP状态码为404 Not Found或30x Redirect的请求。
    • 点击失败的请求,查看其“标头”(Headers)或“响应”(Response)选项卡,了解请求的完整URL以及服务器的响应内容。

如果发现style.css或bg.jpg等静态资源的请求状态码是404,或者它们的请求被重定向到了非预期的URL(例如重定向到了主页),那么就确认了问题出在Rewrite规则对静态资源路径的干扰上。

Background Eraser
Background Eraser

AI自动删除图片背景

下载

解决方案

解决这类问题主要有两种策略:调整静态资源的引用路径,或者修改Rewrite规则以排除静态资源。

方案一:调整静态资源路径为根相对路径

最直接的解决方案之一是将HTML中对静态资源的相对路径改为根相对路径。

示例: 将index.html中的:


修改为:


在路径前添加斜杠/,表示这是一个根相对路径。这意味着无论当前页面的URL是什么,浏览器都会从网站的根目录开始查找css/style.css或images/favicon.ico。这种方法在重定向发生后,能够确保浏览器总是向正确的服务器路径请求静态文件,而不会受到当前重定向后URL的影响。

方案二:在Rewrite规则中排除静态资源

更健壮和推荐的方法是修改web.config中的Rewrite规则,明确告诉IIS不要对静态资源文件执行重写或重定向。这可以通过添加条件()来实现。

示例: 修改你的web.config文件,在Rewrite规则中添加条件,排除对css和images目录下的文件以及常见静态文件扩展名的重定向。



    
        
            
                
                    
                    
                        
                        
                        
                        
                    
                    
                
            
        
    

解释:

  • :这条规则仍然匹配所有请求。
  • :在这里我们添加了条件。
    • input="{REQUEST_URI}":指定检查的输入是请求的URI路径。
    • pattern="^/(css|images)/":这是一个正则表达式,匹配以/css/或/images/开头的URI路径。
    • negate="true":这是关键。它表示“如果输入(REQUEST_URI)不匹配这个模式,则条件为真”。
    • 结合起来,这条条件的意思是:如果请求的URI不是以/css/或/images/开头,那么就继续执行规则的action。这样,对CSS和图片文件的请求就不会被重定向。

你可以根据需要调整正则表达式,例如添加更多的静态文件目录或文件扩展名。

方案三(临时验证):复制静态文件

这是一种快速验证问题是否出在路径上的临时方法,不推荐作为长期解决方案。 将所有静态文件(如style.css、bg.jpg、favicon.ico)直接复制到网站的根目录。然后修改HTML中的引用路径,使其直接指向根目录下的文件(例如href="style.css")。如果页面样式恢复正常,则说明问题确实是由于Rewrite规则导致静态文件路径解析错误。此方法仅用于诊断,不应在生产环境中使用。

注意事项

  • 清除缓存: 在修改web.config或HTML文件后,务必清除浏览器缓存(Ctrl+F5)以及IIS的缓存(如果适用),以确保加载的是最新文件。
  • 规则顺序: 在web.config的部分中,规则的顺序非常重要。IIS会按照它们出现的顺序处理规则。如果有一个非常宽泛的规则(如匹配所有请求的规则)放在前面且stopProcessing="true",它可能会阻止后续更具体的规则被执行。
  • 重写与重定向: 理解action type="Rewrite"(服务器内部处理,浏览器地址栏不变)和action type="Redirect"(客户端行为,浏览器地址栏改变)的区别。本教程中的问题是由Redirect引起的。

总结

IIS的URL Rewrite模块功能强大,但在配置时需要仔细考虑其对所有请求(包括静态资源)的影响。当遇到静态资源加载失败的问题时,首先应利用浏览器开发者工具诊断,确认是404错误还是重定向循环。随后,可以根据具体情况选择调整静态资源引用路径为根相对路径,或在Rewrite规则中通过条件排除静态资源,以确保网站在应用URL Rewrite策略的同时,依然能够正常显示和运行。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

557

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

395

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

756

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

478

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

474

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

1051

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

658

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

554

2023.09.20

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

CSS教程
CSS教程

共754课时 | 22.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号