Symfony虚拟主机环境下无法从web公共文件夹获取图片的问题

API 探路者

2026-5-20

解决Symfony虚拟主机下无法访问web目录静态文件的问题

嘿，我来帮你搞定这个问题！你遇到的“No route found”错误，根源出在虚拟主机配置和Twig模板的路径写法上，咱们一步步来修复：

1. 修正虚拟主机配置问题

你当前的httpd-vhosts.conf把DocumentRoot直接指向了app_dev.php，这会导致所有请求（包括静态图片）都被Symfony的前端控制器接管，而Symfony找不到对应/uploads/images/2.jpeg的路由，自然就抛出了错误。

正确的做法是把DocumentRoot指向web目录，同时添加重写规则，让Apache先尝试加载静态文件，找不到再交给Symfony处理。修改后的配置如下：

<VirtualHost *:80>
  DocumentRoot D:/XAMPP/htdocs/symphony/web
  ServerName symphony.com
  <Directory D:/XAMPP/htdocs/symphony/web>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    allow from all

    # 开发环境重写规则：静态文件存在就直接返回，否则交给app_dev.php处理
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ app_dev.php [QSA,L]
  </Directory>
</VirtualHost>

2. 修正Twig模板中的图片路径

你现在用{{ url('todo_list') }}uploads/images/2.jpeg生成的路径会带上todo_list路由的前缀（比如/todo-list/uploads/images/2.jpeg），这和静态文件的实际位置完全不匹配。

推荐用Symfony内置的asset()函数来生成正确的静态文件URL，它会自动适配你的环境配置：

{% extends 'base.html.twig' %}

{% block body %}
<h2>Todo Edit</h2>
{{form_start(form)}}
{{form_widget(form)}}

{# 用asset函数生成正确的静态文件路径 #}
<img src="{{ asset('uploads/images/2.jpeg') }}" />

{{form_end(form)}}
{% endblock %}

当然你也可以直接写根路径的绝对路径<img src="/uploads/images/2.jpeg" />，但asset()函数在部署到子目录等场景下会更灵活。