如何解决Shiny Server部署Bookdown文档访问空白的问题

Shiny Server默认对目录下的.Rmd文件调用rmarkdown::render()函数进行单文件渲染，而Bookdown是多文件协同的项目结构，需要调用bookdown::render_book()渲染整个项目的所有文件，这就是你仅得到单个章节输出、访问返回空白页的核心原因。

方案一：预渲染静态文档后托管（最稳定，优先推荐） #

该方案不需要动态渲染，性能更高，也不会出现渲染逻辑兼容问题：

• 先在本地的bookdown-demo项目根目录下执行R命令bookdown::render_book(output_dir = "_book")，完整渲染后的静态站点文件会全部生成在_book子目录下
• 修改docker-compose.yml中的volumes挂载规则，直接挂载预生成的静态目录：

volumes:
  - ./bookdown-demo/_book:/srv/shiny-server/book

• 重启容器后访问localhost/book即可正常打开完整的Bookdown文档。

方案二：配置动态渲染（适用于需要实时更新文档内容的场景） #

如果需要每次访问时都动态渲染最新的文档内容，需要调整项目配置让Shiny Server调用正确的渲染函数：

1. 在bookdown-demo项目根目录下新建.Rprofile文件，写入以下内容：

options(rmarkdown.render.function = function(...) {
  bookdown::render_book(...)
})

2. 检查项目根目录下index.Rmd的YAML头部，确认输出格式指定为Bookdown的对应格式，示例如下：

output:
  bookdown::gitbook: default

3. 重启容器后再次访问即可动态渲染完整站点。

• 权限问题：Shiny Server默认以shiny用户运行，需要对挂载的本地目录有读取权限，可在本地执行sudo chmod -R 755 ./bookdown-demo赋予全局读权限，也可以取消docker-compose配置中user: 'root'的注释，用root身份运行容器规避权限问题。
• 若使用方案二，需要额外赋予挂载目录写入权限，否则渲染过程中生成的临时文件和输出文件无法正常保存，会导致渲染失败。

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