Tin Can API(xAPI)启动故障求助：Storyline制xAPI课程浏览器启动失败

咱们一步步来拆解可能的问题，帮你定位课程启动失败的原因：

1. 先验证LRS端点的可达性 #

• 直接在浏览器地址栏访问你的LRS端点 http://192.168.168.66/data/xAPI/，看看是否能正常返回响应（通常是JSON格式提示或LRS验证页面）。如果访问失败，大概率是LRS服务未启动、服务器端口被防火墙限制，或者本地网络存在连通性问题。
• 确认本地域名 xapi.local.lcl 是否正确解析到对应服务器IP：检查本地hosts文件里有没有配置这条映射，避免域名解析失败导致无法加载launcher.html。

2. 检查启动URL的格式正确性 #

你的启动URL参数分隔可能存在异常：

• 注意到URL里端点和auth参数之间用的是%26（&的URL编码），虽然编码本身合规，但部分解析器可能处理异常。建议直接替换成&，生成新URL测试：

  http://xapi.local.lcl/launcher.html?endpoint=http://192.168.168.66/data/xAPI/&auth=Basic%20YWMwMWQ1NzliNmUzMWZlYzUwYTE3ZTI1NzBjMzI2ZmEwMjhjZTJkMjpjNzUzMGUwZTJjYjVjYWJmODFkOTYwZDIyODFhYTI5ZmZlN2EzYjA...
  

• 验证auth参数的Base64编码是否正确：把LRS密钥和密钥详情用:拼接后做Base64编码（比如密钥:密钥详情），对比编码结果是否和URL中的字符串一致。编码错误会直接导致LRS认证失败。

3. 查看浏览器控制台的错误日志 #

启动课程时按下F12打开开发者工具，重点看这两个标签：

• Console：这里的报错会直接点明问题，比如跨域（CORS）错误、launcher.html加载失败、xAPI请求认证失败等。
• Network：查看所有请求的状态码：如果launcher.html返回404，说明文件路径不对；LRS请求返回401是认证信息错误；403是权限问题；500则是LRS服务器内部故障。

4. 确认Storyline课程的xAPI发布配置 #

• 检查发布课程时是否正确选择了xAPI选项，且配置的LRS端点、密钥和你生成启动URL时用的完全一致，有没有拼写或大小写错误。
• 确认发布的课程文件是否完整上传到xapi.local.lcl对应的服务器目录：比如launcher.html是否和story_content等课程资源文件夹在同一目录，避免加载资源时路径错误。

5. 测试LRS的基本认证有效性 #

用curl命令或Postman测试LRS认证是否正常：

curl -H "Authorization: Basic YWMwMWQ1NzliNmUzMWZlYzUwYTE3ZTI1NzBjMzI2ZmEwMjhjZTJkMjpjNzUzMGUwZTJjYjVjYWJmODFkOTYwZDIyODFhYTI5ZmZlN2EzYjA..." http://192.168.168.66/data/xAPI/

如果返回正常响应，说明认证没问题；如果返回401，那就是认证信息错误，需要重新生成正确的Base64编码。

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