部署R Shiny应用至shinyapps.io时appPrimaryDoc错误求助

问题原因 #

shinyapps.io部署时会自动识别主文档：优先找根目录下的app.R、server.R+ui.R组合，或是.html文件。如果你的项目结构不符合这些常规模式，就会触发Failed to determine appPrimaryDoc错误。

HTML文件的要求 #

• 可以是极简基础HTML文件（仅作为主文档标识），也可以是关联Shiny UI的模板文件
• 文件名必须和你在primaryDoc参数中指定的完全一致（比如你用了index.html，文件名就不能错）
• 如果用shiny::htmlTemplate()关联Shiny UI，文件中需要预留占位符（比如{{ content }}）来渲染UI内容

创建方法 #

方法1：极简占位HTML（快速解决部署识别问题） #

直接创建一个基础结构的HTML文件，不需要复杂内容，仅用于让shinyapps.io识别主文档：

<!DOCTYPE html>
<html>
<head>
  <title>PH1 Shiny App</title>
</head>
<body>
</body>
</html>

方法2：关联Shiny UI的HTML模板（自定义页面结构） #

如果需要自定义HTML布局，可按以下步骤操作：

1. 创建index.html文件，加入Shiny占位符：

<!DOCTYPE html>
<html>
<head>
  <title>PH1 Shiny App</title>
  {{ headContent() }} <!-- 加载Shiny默认的JS/CSS资源 -->
</head>
<body>
  <div class="custom-container">
    {{ content }} <!-- 这里会渲染你的Shiny UI代码 -->
  </div>
</body>
</html>

2. 在R代码中引用该模板：

ui <- htmlTemplate("index.html", content = tagList(
  # 替换成你的实际Shiny UI代码
  fluidPage(
    titlePanel("PH1 应用"),
    sidebarLayout(
      sidebarPanel(),
      mainPanel()
    )
  )
))

server <- function(input, output) {
  # 你的Server逻辑代码
}

shinyApp(ui, server, options = list(primaryDoc = "index.html"))

存放位置 #

• 必须放在Shiny应用的根目录下（和app.R/server.R/ui.R处于同一层级）
• 检查GitHub仓库的.gitignore文件，确保没有忽略.html后缀的文件，否则部署时文件不会被上传到shinyapps.io

额外提示 #

如果你的项目是常规的app.R或server.R+ui.R结构，先检查文件名是否正确（shinyapps.io对文件名大小写敏感，比如App.R不会被识别为默认主文档），这种情况下其实不需要额外创建HTML文件。

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