Pimcore中encore_entry_link_tags等Twig函数触发内部服务器错误

在本地搭建Pimcore网站时，调用encore_entry_link_tags('app')或encore_entry_script_tags('app')均触发内部服务器错误，单独调用其中一个也无法解决。已按Symfony指南完成Webpack Encore安装，npm run build可正常将SCSS和JS打包至public/build目录，但Twig函数调用始终失败。相关webpack.config.js配置如下：

const Encore = require("@symfony/webpack-encore");

// Manually configure the runtime environment if not already configured yet by the "encore" command.
// It's useful when you use tools that rely on webpack.config.js file.
if (!Encore.isRuntimeEnvironmentConfigured()) {
    Encore.configureRuntimeEnvironment(process.env.NODE_ENV || "dev");
}

Encore
    // directory where compiled assets will be stored
    .setOutputPath("public/build/")
    // public path used by the web server to access the output path
    .setPublicPath("/build")
    // only needed for CDN's or sub-directory deploy
    //.setManifestKeyPrefix('build/')

    /*
     * ENTRY CONFIG
     *
     * Each entry will result in one JavaScript file (e.g. app.js)
     * and one CSS file (e.g. app.css) if your JavaScript imports CSS.
     */
    .addEntry("app", "./assets/app.js")

    // enables the Symfony UX Stimulus bridge (used in assets/bootstrap.js)
    // .enableStimulusBridge("./assets/controllers.json")

    // When enabled, Webpack "splits" your files into smaller pieces for greater optimization.
    .splitEntryChunks()

    // will require an extra script tag for runtime.js
    // but, you probably want this, unless you're building a single-page app
    .enableSingleRuntimeChunk()
    /*
     * FEATURE CONFIG
     *
     * Enable & configure other features below. For a full
     * list of features, see:
     * https://symfony.com/doc/current/frontend.html#adding-more-features
     */
    .cleanupOutputBeforeBuild()
    .enableBuildNotifications()
    .enableSourceMaps(!Encore.isProduction())
    // enables hashed filenames (e.g. app.abc123.css)
    .enableVersioning(Encore.isProduction())
    .enableSassLoader()
    .configureBabel((config) => {
        config.plugins.push("@babel/plugin-transform-class-properties");
    })

    // enables @babel/preset-env polyfills
    .configureBabelPresetEnv((config) => {
        config.useBuiltIns = "usage";
        config.corejs = 3;
    });

// enables Sass/SCSS support

// uncomment if you use TypeScript
//.enableTypeScriptLoader()

// uncomment if you use React
//.enableReactPreset()

// uncomment to get integrity="..." attributes on your script & link tags
// requires WebpackEncoreBundle 1.4 or higher
//.enableIntegrityHashes(Encore.isProduction())

// uncomment if you're having problems with a jQuery plugin
//.autoProvidejQuery()

module.exports = Encore.getWebpackConfig();

关键排查与解决步骤 #

1. 验证WebpackEncoreBundle的安装与配置 #

• 确保通过Composer完成Bundle安装：

  composer require symfony/webpack-encore-bundle
  

• 检查config/bundles.php中是否注册了Bundle：

  return [
      // ...
      Symfony\WebpackEncoreBundle\WebpackEncoreBundle::class => ['all' => true],
      // ...
  ];
  

• 确认config/packages/webpack_encore.yaml路径配置正确：

  webpack_encore:
      output_path: '%kernel.project_dir%/public/build'
  

2. 检查manifest.json文件有效性 #

执行npm run build后，public/build下必须生成manifest.json，且包含app入口的映射关系，示例：

{
  "app.js": "/build/app.abc123.js",
  "app.css": "/build/app.abc123.css",
  "runtime.js": "/build/runtime.def456.js"
}

• 若文件不存在，重新执行npm run build并查看终端输出，排查依赖缺失、路径错误等隐藏打包问题。
• 若文件无app相关条目，检查webpack.config.js中addEntry("app", "./assets/app.js")的路径是否正确，确保./assets/app.js存在且引入了SCSS文件。

3. 定位具体错误日志 #

内部服务器错误的核心原因需通过日志确认：

• 开发环境查看var/log/dev.log，生产环境查看Nginx/Apache等服务器的错误日志。
• 常见错误场景：
  • manifest.json权限不足：确保Web服务器进程（如www-data）拥有文件读取权限。
  • Encore服务未注册：Bundle未正确安装或缓存未更新。

4. 验证Encore服务可用性 #

在Pimcore控制器中手动调用Encore服务，排除Twig函数本身的问题：

// 在控制器方法中添加测试代码
$assetPath = $this->get('webpack_encore.asset_version_strategy')->getAssetPath('app.js');
var_dump($assetPath);

若能正常输出资源路径，说明服务正常，问题出在Twig模板上下文或Pimcore模板加载机制。

5. 简化Webpack配置排查冲突 #

暂时禁用可能引发冲突的配置项，重新打包测试：

// webpack.config.js中注释以下两行
// .splitEntryChunks()
// .enableSingleRuntimeChunk()
// 替换为
.disableSingleRuntimeChunk()

部分Pimcore环境下，runtime chunk的自动引入可能导致路径解析异常，简化配置可快速验证是否为此问题。

6. 清除缓存 #

执行命令清除Symfony和Pimcore的缓存，避免旧配置残留：

php bin/console cache:clear

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