物理路径是文件在服务器硬盘的真实位置，虚拟路径是浏览器访问的URL路径；后端框架通过映射将二者关联，配置错误会导致404。
CSS文件物理路径和虚拟路径到底指什么
物理路径是文件在服务器硬盘上的真实位置，比如
/var/www/myapp/static/css/main.css</p> <p>虚拟路径是你在浏览器地址栏里输入的路径，比如 <code>/static/css/main.css</p> <p>后端框架（如 Flask、Django、Spring Boot）不直接暴露物理路径，而是把某个物理目录映射成一个虚拟前缀。这个映射关系一旦配错，<code><link href="...">就 404。
Flask 中 static_folder 和 static_url_path 怎么配才不 404
默认情况下，Flask 把项目根目录下的 static 文件夹当作静态资源根目录，虚拟路径前缀是 /static。但这两个值都能改，一动就容易出问题：
立即学习“前端免费学习笔记（深入）”；
-
static_folder必须是相对于项目启动目录的**真实存在**的路径，写错或权限不足会导致服务启动失败或返回空响应 -
static_url_path是浏览器访问用的前缀，不以/开头会被拼接到应用根路径后，比如设成assets，那实际要访问/myapp/assets/style.css（如果应用挂载在/myapp下） - 模板里写
<link rel="stylesheet" href="%7B%7B%20url_for('static',%20filename='css/main.css')%20%7D%7D">—— 这个url_for依赖的是static_url_path的配置，不是物理路径
Django 的 STATIC_ROOT、STATICFILES_DIRS 和 MEDIA_URL 容易混吗
它们分工明确，但名字太像，新手常把 STATIC_ROOT 当作开发时放 CSS 的地方：
-
STATICFILES_DIRS：开发阶段，告诉 Django 哪些目录里有静态文件（比如['static_dev']），它会从这些目录收集文件 -
STATIC_ROOT：只在运行python manage.py collectstatic时用，是「收集后」存放所有静态文件的**单个物理目录**，Nginx 或 CDN 实际指向这里；开发时别往这放东西 -
MEDIA_URL和MEDIA_ROOT是给用户上传文件（如头像、附件）用的，和 CSS 无关；误配会导致/media/xxx.css这种错误请求
模板中必须用 {% static 'css/main.css' %}，而不是硬写 /static/css/main.css —— 否则换域名或加 CDN 前缀时全得手动改。
Spring Boot 的 /static 映射被覆盖或失效了怎么办
Spring Boot 默认把 classpath:/static、classpath:/public 等路径自动映射到 / 下，但以下情况会让 CSS 找不到：
- 写了自定义的
@Controller处理/static/**，会拦截原本应由静态资源处理器处理的请求 - 用了 WebMvcConfigurer 并重写了
addResourceHandlers却没调用registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/") - 打包成 jar 后，用
File操作读取static目录——jar 包里没有“文件系统路径”，得用ClassLoader.getResource()或ResourceLoader
检查方法：直接浏览器访问 http://localhost:8080/css/main.css，看能不能下载到内容；如果 404，说明映射没生效或文件没放在正确 classpath 位置。
路径映射不是写对了就行，关键在于请求生命周期里哪一层真正拿到了文件——有时候你以为是前端路径错了，其实是后端连资源处理器都没走到。
