Drupal 8中jQuery依赖报错：网站遇意外错误，请稍后重试

作为长期折腾Drupal主题开发的人，我来帮你排查这个jQuery依赖报错的问题——这是Drupal 8新手常踩的坑之一。结合你的配置文件和报错现象，咱们一步步来：

1. 核心问题：缺少jQuery依赖声明 #

Drupal 8不会自动全局加载jQuery，所有需要用到jQuery的脚本都必须在libraries.yml中明确声明依赖。看你的配置，你在info.yml里加载了xxx/javascript库，但大概率这个库没有添加jQuery依赖。

打开你的xxx.libraries.yml，找到javascript部分，补充依赖配置：

javascript:
  js:
    js/your-custom-script.js: {}  # 替换成你的实际JS文件路径
  dependencies:
    - core/jquery  # 声明依赖Drupal核心的jQuery库

如果你的javascript库之前没有定义，直接加上这段即可；如果已有JS文件，只需要添加dependencies节点。

2. 检查内联脚本的依赖问题 #

如果你在Twig模板或模板文件里写了直接调用jQuery的内联代码（比如$(document).ready(...)），即使你在库中声明了依赖，也可能因为加载顺序问题报错。这种情况有两种解决方式：

• 把内联脚本移到单独的JS文件中，并通过上述libraries.yml加载；
• 在Twig模板中直接附加jQuery库：

  {{ attach_library('core/jquery') }}
  

  或者在主题的.theme文件中添加：

  function xxx_preprocess_page(&$variables) {
    $variables['#attached']['library'][] = 'core/jquery';
  }
  

3. 必须清除Drupal缓存 #

每次修改libraries.yml或info.yml后，一定要清除Drupal的缓存，否则新的配置不会生效。你可以：

• 登录后台，进入「配置」→「性能」→「清除所有缓存」；
• 如果用Drush命令行工具，执行：

  drush cr
  

4. 查看详细错误日志定位问题 #

网站显示“网站遇到意外错误”时，默认不会显示具体报错内容。你可以开启详细错误日志：

1. 登录后台，进入「报告」→「最近的日志消息」，查看具体的报错条目；
2. 或者修改sites/default/settings.php，开启 verbose 错误显示：

   $config['system.logging']['error_level'] = 'verbose';
   

   刷新页面后就能看到具体的报错信息，比如是哪个脚本找不到$或jQuery对象，方便精准修复。

5. 检查Google Fonts引用的完整性 #

你的stylesheets库中引用的Google Fonts URL被截断了（https://fonts.googlea...），确保URL完整，比如：

stylesheets:
  css:
    theme:
      css/style.css: {}
      https://fonts.googleapis.com/css?family=Open+Sans:300,400,700: {}

不完整的外部资源URL可能导致加载失败，间接引发其他异常。

内容的提问来源于stack exchange，提问作者арно нюм