Web 应用程序部署故障诊断技巧
如果您可以通过在浏览器中输入统一资源定位符 (URL) 来访问应用程序或可以通过点击某个链接来访问应用程序,那么 Web 应用程序的部署便已成功。如果您无法访问您的应用程序,那么遵循这些步骤以消去可能会在迁移或部署期间发生的某些常见错误。
从 V4.x 迁移的 Web 模块在较高的 WebSphere Application Server 版本中不能运行
注: 本主题引用了一个或多个应用程序服务器日志文件。作为另一种建议采用的方法,您可以在分布式系统和 IBM® i 系统上配置服务器以使用高性能可扩展日志记录 (HPEL) 记录和跟踪基础结构,而不使用 SystemOut.log、SystemErr.log、trace.log 和 activity.log 文件。您还可以将 HPEL 与本机 z/OS® 日志记录设施结合使用。如果要使用 HPEL,那么可从服务器概要文件
bin 目录使用 LogViewer 命令行工具来访问所有日志和跟踪信息。有关使用
HPEL 的更多信息,请参阅有关使用 HPEL 对应用程序进行故障诊断的信息。
症状 | 问题 | 建议响应 |
---|---|---|
V4.x Web 模块在迁移到 V8.0 或更高版本的产品之后不能运行。 | 在 V4.x 中,影响可视性的类路径设置是模块可视性方式。在 V6.0 及更高版本中,必须使用类装入器策略来设置可视性。 | 重新组装现有模块或更改类装入器策略中的可视性设置。 请参阅“类装入器和类装入”一文,以了解更多信息。 |
欢迎页面不可见。
症状 | 问题 | 建议响应 |
---|---|---|
您无法访问带有以下 Web 路径的应用程序:/webapp/myapp |
假设 Web 应用程序的缺省欢迎页面是 index.html。您无法访问 myapp 应用程序的缺省页面,除非它命名为 index.html。 | 要识别不同的欢迎页面,请在组装期间修改 Web 模块的属性。有关更多信息,请参阅“组装 Web 应用程序”一文。 |
HTML 文件未找到。
症状 | 问题 | 建议响应 |
---|---|---|
您的 Web 应用程序在先前的版本上成功运行,但现在您遇到如下错误:找不到欢迎页面(通常是 index.html)或引用的 HTML 文件:错误 404:找不到文件:Banner.html 错误 404:找不到文件:HomeContent.html |
出于安全性和一致性的原因,Web 应用程序 URL 目前在所有操作系统上都区分大小写。 假定索引页面的内容如下所示: <!DOCTYPE HTML PUBLIC “-//W3C//DTD HTML 5.0 Frameset//EN”> <HTML> <TITLE> Insurance Home Page </TITLE> <frameset rows=“18,80”> <frame src=“Banner.html” name=“BannerFrame” SCROLLING=NO> <frame src=“HomeContent.html” name=“HomeContentFrame”> </frameset> </HTML> 但部署此应用程序的 \WebSphere\AppServer\installedApps\... 目录中实际文件名为: banner.html homecontent.html |
要更正此问题,修改 index.html 文件,将名称 Banner.html 和 HomeContent.html 更改为 banner.html 和 homecontent.html,以与部署的应用程序中文件的名称相匹配。 |
代理服务器无法访问 Web 模块
如果您安装具有相同 Web 模块的两个应用程序时使用相同上下文根,并且其中一个应用程序处于禁用状态。 您无法使用代理服务器来访问 Web 模块。发生此情况时,将在 SystemOut 和 SystemErr 日志中记录错误消息“503 Service Unavailable”。

有关 IBM 支持机构提供的有关已知问题及其解决方法的最新信息,请参阅 IBM 支持页面。
IBM 支持机构提供的文档能节省您在收集解决此问题所需信息上花费的时间。打开 PMR 之前,请参阅 IBM 支持页面。