PHP Phalcon请求处理异常：函数重复执行问题排查

Hey there! I’ve dealt with this exact double-trigger issue in Phalcon before, so let’s break down the most likely causes and how to fix them:

• Favicon.ico Requests (Most Common)
  Browsers automatically send a request for /favicon.ico when loading any page. If your app doesn’t handle this request explicitly, Phalcon will route it through your normal application flow—meaning your index.php and controller onConstruct run twice (once for your actual page, once for the favicon).
  Fix this by either:

  1. Placing a favicon.ico file in your public directory, so the server serves it directly without hitting your Phalcon app.
  2. Adding a dedicated route to handle the favicon request:

     $router->add('/favicon.ico', [
         'controller' => 'index',
         'action' => 'serveFavicon'
     ]);
     

     Then in your IndexController, add a method to return the favicon or a 204 no-content response to skip the full controller lifecycle.

• Duplicate Route Registrations
  Double-check your route configuration files—if you accidentally registered the same route rule twice (e.g., in both a base config and a module-specific config), each request will match both routes and trigger your logic twice.

• Misconfigured .htaccess (Apache)
  If you’re using Apache, a bad RewriteRule can cause requests to be rewritten or redirected multiple times. For example, a rule that doesn’t properly exclude existing files/directories might loop, leading to Phalcon receiving duplicate requests. Verify your .htaccess follows Phalcon’s recommended setup:

  <IfModule mod_rewrite.c>
      RewriteEngine On
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteRule ^(.*)$ index.php?_url=/$1 [QSA,L]
  </IfModule>
  

• Debug Toolbar or Third-Party Extensions
  Phalcon’s debug toolbar (or other third-party plugins) sometimes makes extra requests to fetch debug data, which can trigger your app logic again. Try disabling the debug toolbar temporarily to see if the duplicate logs stop.

• Browser Preloading/Cache
  Some modern browsers use preloading features to speed up navigation, which might send an extra request before you even fully load the page. Test your app with curl instead of a browser:

  curl http://your-phalcon-site.com
  

  If the log only shows one entry with curl, the issue is browser-specific.

Quick Debug Tip #

To pinpoint exactly what’s causing the double request, add the request URI to your logs:

// In index.php
$uri = $_SERVER['REQUEST_URI'];
fwrite(fopen("log.txt", "a+"),"index - $uri\n");

// In BaseController::onConstruct()
$uri = $_SERVER['REQUEST_URI'];
fwrite(fopen("log.txt", "a+"), "base - $uri\n");

This will show you if the second execution is coming from /favicon.ico or another unexpected URI.

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