Symfony 4.1项目新增路由出现404 NotFound问题求助

Hey there! Let's work through fixing that 404 error you're seeing when trying to access your /search-user endpoint. Here are the key checks to run:

1. Ensure Annotation Support is Enabled #

Symfony 4.1 relies on the sensio/framework-extra-bundle to handle route annotations.

• First, check if the bundle is installed by looking for it in your composer.json file. If it's missing, install it with:

  composer require sensio/framework-extra-bundle
  

• Next, verify the bundle is enabled in config/bundles.php—you should see this line:

  Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true],
  

2. Validate Your Controller Setup #

Make sure your controller file is properly structured:

• It must be located in the src/Controller/ directory.
• The namespace at the top should be namespace App\Controller;.
• You need to import the required classes:

  use Symfony\Component\HttpFoundation\Request;
  use Symfony\Component\Routing\Annotation\Route;
  

  Without importing the Route annotation, Symfony won't recognize the @Route decorator on your method.

3. Clear Symfony's Cache #

Symfony caches route definitions, and stale cache can cause missing routes. Clear it with:

• For development environment:

  php bin/console cache:clear
  

• For production environment:

  php bin/console cache:clear --env=prod
  

4. Check if the Route is Registered #

List all active routes to confirm /search-user exists. Run this command:

php bin/console debug:router

Look for the search-user entry in the output. If it's not listed, Symfony isn't picking up your annotation—go back to steps 1 and 2 to fix that.

5. Verify Your routes.yaml Configuration #

Your current config looks correct, but double-check:

• The resource path ../src/Controller/ points to the right directory.
• There are no typos or conflicting routes in the file that might override /search-user.

6. Check Web Server Configuration #

If you're using Apache, ensure the public/.htaccess file exists and is correctly configured to forward all requests to index.php. For Nginx, confirm your server block includes rewrite rules that send requests to public/index.php.

After going through these steps, try accessing /search-user again. If you still hit a 404, share the output of debug:router and any relevant logs from var/log/dev.log (for dev mode) and we can troubleshoot further!

内容的提问来源于stack exchange，提问作者El Hombre Sin Nombre