如何在Shiny中正确使用tags$script？加载本地JS遇404错误

你遇到的404错误，核心是没搞清楚includeScript和tags$script的工作机制差异，以及Shiny对静态资源目录的引用规则。

两者的本质区别 #

• includeScript("www/script.js")：直接读取本地脚本文件的内容，把代码嵌入到生成的HTML页面中，不需要浏览器额外请求资源——只要本地文件路径正确，就能正常运行。
• tags$script(src = "script.js")：生成一个外部脚本引用标签，让浏览器主动请求对应URL的资源，这时候必须依赖Shiny的静态资源服务机制才能找到文件。

Shiny的静态资源规则 #

Shiny默认会把app所在目录下的www文件夹作为静态资源根目录：浏览器请求http://你的app地址/script.js时，Shiny会自动返回www/script.js的内容。但这个规则生效的前提是：你的R工作目录必须是app.R所在的目录（也就是www的父目录）。

正确的写法 #

针对你的场景，有三种可靠的解决方式：

方式一：使用根路径引用（推荐本地开发用）

确保工作目录是app.R所在文件夹，直接在src前加斜杠（强制从根路径请求资源，避免子路径干扰）：

library(shiny)

ui <- fluidPage(
  tags$head(
    tags$script(src = "/script.js")
  ),
  tags$h1("Hello World")
)

server <- function(input, output, session) {

}

shinyApp(ui, server)

方式二：注册资源路径（适合复杂场景或部署）

通过addResourcePath明确映射本地目录到URL前缀，彻底避免工作目录问题：

library(shiny)

server <- function(input, output, session) {
  # 把本地www目录映射为URL上的"js"前缀
  addResourcePath(prefix = "js", directoryPath = "www")
}

ui <- fluidPage(
  tags$head(
    tags$script(src = "js/script.js")
  ),
  tags$h1("Hello World")
)

shinyApp(ui, server)

方式三：直接嵌入脚本内容（和includeScript效果一致）

如果脚本代码不多，可以直接读取文件内容嵌入到HTML中，无需外部请求：

library(shiny)

ui <- fluidPage(
  tags$head(
    tags$script(HTML(readLines("www/script.js")))
  ),
  tags$h1("Hello World")
)

server <- function(input, output, session) {

}

shinyApp(ui, server)

排查要点 #

• 确认www目录和app.R在同一文件夹下，文件名（包括大小写）完全正确（比如script.js不能写成Script.js）。
• 运行app前检查工作目录：在app.R开头加print(getwd())，输出路径应是app.R所在文件夹。如果不对，可手动设置setwd("你的app所在文件夹路径")，或在RStudio中点击"Run App"时选择"Run Directory"为"Current Working Directory"。

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