Symfony 5重置密码邮件URL缺失/projectName/public/路径求助

问题说明 #

在Symfony 5新项目里实现重置密码功能时，其他功能都正常，但邮件里生成的重置URL少了/projectName/public/部分——期望是http://localhost/projectName/public/reset-password/reset/xOdfPc0iGC7nmReqX02jcemgX4EIlt2tb5vNYgTZ，实际生成的URL没有这段路径，导致用户点击后无法访问重置页面。

修复方案 #

1. 配置框架全局路由基础路径（推荐） #

直接在config/packages/framework.yaml里设置路由的基础路径，这样所有通过url()生成的链接都会自动带上这段路径：

framework:
    router:
        base_path: '/projectName/public'

修改完成后清空缓存：php bin/console cache:clear，再测试发送邮件即可。

2. 手动传入请求上下文（适合CLI发送邮件场景） #

如果是通过命令行触发邮件发送（比如定时任务），此时没有HTTP请求上下文，Symfony无法自动获取项目路径，需要手动传递：
首先修改发送邮件的控制器方法，注入RequestStack：

private function processSendingPasswordResetEmail(string $emailFormData, MailerInterface $mailer, TranslatorInterface $translator, RequestStack $requestStack): RedirectResponse
{
    // ... 原有代码保持不变 ...

    // 获取当前请求的完整基础路径（比如http://localhost/projectName/public）
    $baseUrl = $requestStack->getCurrentRequest()->getSchemeAndHttpHost() . $requestStack->getCurrentRequest()->getBaseUrl();

    $email = (new TemplatedEmail())
        ->from(new Address('assistance@asintel.com', 'AS Intel - Assistance'))
        ->to($user->getEmail())
        ->subject('重置密码请求')
        ->htmlTemplate('reset_password/email.html.twig')
        ->context([
            'resetToken' => $resetToken,
            'baseUrl' => $baseUrl,
        ])
    ;

    $mailer->send($email);

    // ... 原有代码保持不变 ...
}

然后修改Twig模板，用baseUrl拼接相对路径：

<h1>Bonjour !</h1>

<p>Pour réinitialiser votre mot de passe, merci de vous rendre sur le lien suivant</p>

<a href="{{ baseUrl ~ path('app_reset_password', { token: resetToken.token }) }}">
    {{ baseUrl ~ path('app_reset_password', { token: resetToken.token }) }}
</a>

<p>Ce lien expirera dans {{ resetToken.expirationMessageKey|trans(resetToken.expirationMessageData, 'ResetPasswordBundle') }}.</p>

<p>A bientôt !</p>

3. 临时硬编码路径（仅测试用） #

如果只是临时测试，可以直接在Twig的url()函数里指定base_url参数：

<a href="{{ url('app_reset_password', { token: resetToken.token }, { scheme: 'http', base_url: '/projectName/public' }) }}">
    {{ url('app_reset_password', { token: resetToken.token }, { scheme: 'http', base_url: '/projectName/public' }) }}
</a>

注意：生产环境不建议这么做，后续项目路径变更时需要同步修改模板，维护成本高。

问题根源 #

Symfony的url()函数生成绝对URL时，依赖当前请求的上下文信息（包括域名、基础路径）。如果发送邮件时未获取到正确的请求上下文（比如CLI环境），或者框架未配置基础路径，就会生成不带项目路径的URL。

内容的提问来源于stack exchange，提问作者FrancoisF