Symfony 5 Webpack Encore静态资源在Apache部署失效及.htaccess解决方法

问题表现 #

• 按照Symfony官方部署流程操作后，public目录下自带的.htaccess可保障所有控制器路由正常运行
• 本地开发环境无异常，Webpack Encore编译的CSS、JS、Bootstrap资源加载完全正常，但部署到服务器后所有编译资源完全不生效；无论切换开发还是生产环境模式，问题始终存在
• 手动在base.html.twig中直接写入CSS引入路径测试时，首页（/路由）可正常加载样式，但页面内嵌图片无法显示；跳转至其他控制器路由时，所有样式完全失效
• 曾尝试取消public/.htaccess中Options +FollowSymlinks的注释，问题无任何改善

现有配置说明 #

1. public目录下的.htaccess #

使用Symfony官方提供的默认重写规则，核心逻辑包括：

• 指定index.php为站点默认入口文件
• 关闭MultiViews功能，避免路由解析时出现不必要的内容协商冲突
• 自动识别当前站点的重写基路径、透传被Apache移除的HTTP_AUTHORIZATION请求头、移除URL中冗余的index.php片段避免重复内容、将不存在的静态文件请求回退到前端控制器处理

2. webpack.config.js #

使用Webpack Encore默认初始化配置，核心参数：

• 编译后的资源输出路径设置为public/build/
• Web服务器访问编译资源的基础路径设置为/build
• 生产环境下开启资源文件版本哈希、关闭SourceMap、启用代码拆分、配置单运行时块、支持Sass预编译、接入Symfony UX Stimulus桥接

问题根因与解决方案 #

根因 #

共享主机的Web根目录直接指向Symfony项目根目录，而非Symfony要求的public/目录，导致所有静态资源、路由请求都无法正确命中public目录下的文件与重写规则，引发路径解析混乱、静态资源404、子路由下样式加载失效的问题。

解决方法 #

在项目根目录新增.htaccess文件，写入以下重写规则，将所有请求内部重定向到public目录下处理：

RewriteEngine on

RewriteCond %{REQUEST_URI} !^/public
RewriteRule ^(.*)$ /public/$1 [NC,L]

规则生效逻辑：

• 所有未以/public开头的请求，都会被内部转发到public目录下，匹配对应静态资源或路由规则
• 静态资源请求会直接命中public目录下编译生成的build、图片等文件，不会出现跨路由下的路径解析错误
• 路由请求会正确传递到public目录下的index.php前端控制器，和官方默认的路由规则完全兼容

内容的提问来源于stack exchange，提问作者Cristian Rodriguez Navarro