在 react 应用中，当使用自定义 `usescript` hook 注入外部 j*ascript 文件时，若采用相对路径，在标准路由下可能正常工作，但在动态路由下则可能因路径解析错误导致脚本加载失败，并抛出“unexpected token '

理解 React 应用中的脚本注入与路径问题

在现代前端应用，尤其是基于 React 的单页应用（SPA）中，动态加载外部 J*aScript 脚本是一种常见的需求，例如集成第三方分析工具、广告SDK或特定功能的库。通常，我们会封装一个自定义 Hook（如 useScript）来管理脚本的生命周期，包括创建、加载、错误处理和清理。

然而，在处理脚本路径时，一个常见的陷阱是使用相对路径。当 React Router 等库引入动态路由时，相对路径的解析行为会发生变化，从而导致脚本加载失败。

示例 useScript Hook

以下是一个典型的 useScript Hook 实现，它负责将指定 URL 的脚本注入到 document.head 中：

import { useEffect, useState } from 'react'
import { useLocation } from 'react-router-dom'

const useScript = (url) => {
  const [status, setStatus] = useState(url ? 'loading' : 'idle')
  const location = useLocation() // 引入 useLocation 以在路由变化时重新评估

  useEffect(() => {
    if (!url) {
      setStatus('idle')
      return
    }

    let script = document.querySelector(`script[src="${url}"]`)

    if (!script) {
      script = document.createElement('script')
      script.src = url
      script.type = 'text/j*ascript'
      script.async = true

      document.head.appendChild(script)

      const setAttributeFromEvent = (event) => {
        script.setAttribute(
          'data-status',
          event.type === 'load' ? 'ready' : 'error'
        )
      }

      script.addEventListener('load', setAttributeFromEvent)
      script.addEventListener('error', setAttributeFromEvent)
    } else {
      // 如果脚本已存在，则从其 data-status 属性获取状态
      setStatus(script.getAttribute('data-status'))
    }

    const setStateFromEvent = (event) => {
      setStatus(event.type === 'load' ? 'ready' : 'error')
    }

    script.addEventListener('load', setStateFromEvent)
    script.addEventListener('error', setStateFromEvent)

    return () => {
      if (script) {
        script.removeEventListener('load', setStateFromEvent)
        script.removeEventListener('error', setStateFromEvent)
      }
    }
  }, [url, location]) // 依赖项中包含 url 和 location

  return status
}

export default useScript

这个 Hook 在标准路由（如 /offer）下可能工作正常，但在动态路由（如 /hearing-agency/brand/:brandname）下，当 useScript('./tagging.js') 被调用时，就会出现问题。

问题根源：相对路径解析与动态路由

当你在 React 组件中使用 useScript('./tagging.js') 这样的相对路径时，浏览器会根据当前页面的 URL 来解析这个相对路径。

• 标准路由示例： 如果当前 URL 是 http://localhost:3000/offer，那么 ./tagging.js 会被解析为 http://localhost:3000/tagging.js。这通常是正确的，因为 tagging.js 文件很可能位于应用的根目录（public 文件夹）下。
• 动态路由示例： 如果当前 URL 是 http://localhost:3000/hearing-agency/brand/phonak，那么 ./tagging.js 会被解析为 http://localhost:3000/hearing-agency/brand/tagging.js。

问题就在于，在动态路由的场景下，浏览器会尝试从 http://localhost:3000/hearing-agency/brand/ 路径下去查找 tagging.js。如果你的 tagging.js 文件实际上位于 public 文件夹的根目录，那么这个解析后的 URL 将是错误的。服务器会返回一个针对 http://localhost:3000/hearing-agency/brand/tagging.js 的 404 错误页面，或者在开发服务器中，它可能会返回应用的 index.html 文件。

MarsCode

字节跳动旗下的免费AI编程工具

339 查看详情

当浏览器尝试将一个 HTML 文件（或 404 错误页面）作为 J*aScript 脚本来解析时，它会遇到

解决方案：使用绝对路径

解决此问题的最直接和最可靠的方法是使用绝对路径来引用你的脚本文件。绝对路径会从 Web 根目录开始解析，而不受当前 URL 路径的影响。

将 useScript('./tagging.js') 修改为 useScript('/tagging.js') 即可。

// 在组件中调用 useScript
import useScript from './hooks/useScript'; // 假设 useScript 在此路径

function MyComponent() {
  // 使用绝对路径引用脚本
  const status = useScript('/tagging.js'); 
  console.log('Script status:', status);

  // ... 组件的其他逻辑
}

通过将路径更改为 /tagging.js：

• 无论当前 URL 是 http://localhost:3000/offer 还是 http://localhost:3000/hearing-agency/brand/phonak，script.src 都会被正确解析为 http://localhost:3000/tagging.js。
• 这样，浏览器就能准确地从应用的根目录加载 tagging.js 文件，避免了路径解析错误和随之而来的语法错误。

注意事项与最佳实践

1. 静态资源管理： 对于放置在 public 文件夹中的静态资源（如 tagging.js），始终建议使用以 / 开头的绝对路径。这样可以确保它们在任何路由下都能被正确访问。
2. 部署到子目录： 如果你的 React 应用不是部署在域名的根目录，而是部署在某个子目录（例如 http://www.example.com/my-app/），那么直接使用 /tagging.js 可能会有问题，因为它会解析到 http://www.example.com/tagging.js。在这种情况下，你应该使用环境变量来构建路径，例如 process.env.PUBLIC_URL + '/tagging.js'。
   • 在 Create React App (CRA) 项目中，process.env.PUBLIC_URL 会在构建时自动替换为你在 package.json 中配置的 homepage 字段值或默认为空字符串，从而正确处理子目录部署。
3. useScript Hook 的健壮性： 示例中的 useScript Hook 已经考虑了脚本重复加载和状态管理，这是一个良好的实践。通过 useEffect 的依赖数组中包含 url 和 location，可以确保当脚本 URL 改变或路由变化时，Hook 能够重新评估并处理脚本加载。

总结

在 React 应用中，当使用自定义 Hook 动态注入脚本并遇到“Unexpected token '

以上就是React 动态路由下脚本注入失败的解决方案的详细内容，更多请关注其它相关文章！

# 有何不同  # 泰安网站建设项目  # 摄影关键词排名查询  # 铜仁seo优化  # 淘宝seo老a  # 如何检查自己的网站优化  # 帮别人推广一个网站  # 永久免费个人网站建设  # 商业网站推广对云速接棒  # 烟台网站优化企业有哪些  # 关键词排名怎么看  # 就会  # react  # 是一个  # 如何实现  # 服务端  # 它会  # 但在  # 你在  # 自定义  # 加载  # 路由  # java  # javascript 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： Composer的 archive 命令怎么用_快速打包你的PHP项目及其Composer依赖  如何将一个大型PHP应用拆分为多个Composer包_微服务与模块化架构的Composer实践  如何高效处理PHP中的Excel数据导入导出？PortPHP/Spreadsheet助你轻松搞定！  在VS Code中配置和运行Dart程序的完整步骤  电脑安装程序提示“错误1722”怎么办_Windows Installer服务问题解决【教程】  Python字典中优雅地迭代剩余元素的方法  QQ邮箱官方登录入口_QQ邮箱网页版快捷使用平台  C#如何安全地从用户上传的XML文件中读取数据？ 验证与清理策略  MongoDB聚合管道：正确匹配对象数组中_id的方法  UC浏览器如何安装插件 UC浏览器添加扩展程序详细教程【进阶】  夸克浏览器图书入口 夸克手机浏览器阅读入口  淘宝网网页版登录入口 淘宝官方网页版快捷登录  抖音DOU+怎么投最有效 抖音付费推广的ROI提升技巧  React项目中导航栏Logo自适应布局：避免裁剪与布局溢出  小米14应用无法联网原因分析_小米14网络权限修复  在Pyomo中实现基于变量的条件约束：Big-M方法详解  PHP高效扁平化嵌套数组：使用array_merge与数组解包操作符  千牛数据看板网页版_千牛数据看板网页版访问方法  优化 Jest 模拟：强制未实现函数抛出错误以提升测试效率  在J*a中如何使用Stream.map转换元素_Stream映射操作解析  零跑汽车11月交付量达70327台 实现连续9个月正增长  Safari自带网页翻译功能怎么用 无需插件轻松看懂外文网站【方法】  J*a递归快速排序中静态变量导致数据累积的陷阱与解决方案  俄罗斯Yandex免登录入口_Yandex搜索引擎官网一键直达  PrimeNG Sidebar背景色自定义指南：CSS覆盖与主题化实践  谷歌浏览器如何快速清除某个网站的数据_Chrome网站缓存清理方法  Yandex官网搜索引擎免登录_俄罗斯Yandex一键直达入口  excel怎么制作工资条 excel快速生成工资条的方法  铃兰之剑为这和平的世界希里技能组及加点推荐  Go Martini框架：动态服务解码后的图片内容  天眼查怎么看公司融资情况 天眼查企业融资历史查询步骤【攻略】  谷歌浏览器怎么给标签页静音_Chrome标签静音快捷操作  Excel中VLOOKUP的第四个参数是干什么用的_Excel VLOOKUP第四参数作用解析  QQ邮箱网页版邮箱入口 QQ邮箱官方登录平台  如何在CSS中使用visited与link控制链接颜色_visited link伪类配合  如何设置Windows Defender的定时扫描_计划任务实现自动杀毒【安全】  如何将HTML表格多行数据保存到Google Sheet  如何使用Rector自动化升级旧代码_通过Composer安装和配置Rector进行代码重构  TikTok评论显示延迟如何处理 TikTok评论刷新优化方法  J*aScriptWebpack优化_J*aScript构建工具实战  使用 Pandas 高效处理 .dat 文件：字符清理与数据计算  飞书妙记怎样用语音转文字速记_飞书妙记用语音转文字速记【速记方法】  2026年CSGO开箱网站推荐 CSGO开箱平台精选  J*a编写用户注册与登录功能_掌握字符串与验证逻辑  修复二维数组索引越界异常：一维循环到二维坐标的正确映射  如何在更新Composer依赖后自动运行测试_使用post-update-cmd钩子触发PHPUnit  印象笔记如何设提醒任务防漏执行_印象笔记设提醒任务防漏执行【任务提醒】  汽水音乐车机版8.9下载 汽水音乐车机版8.9版本安装入口  腾讯QQ邮箱登录入口_QQ邮箱官方网站使用地址  解决macOS上安装pyhdf时‘hdf.h’文件缺失的编译错误