Web 应用程序部署故障诊断技巧

如果您可以通过在浏览器中输入统一资源定位符 (URL) 来访问应用程序或可以通过点击某个链接来访问应用程序，那么 Web 应用程序的部署便已成功。如果您无法访问您的应用程序，那么遵循这些步骤以消去可能会在迁移或部署期间发生的某些常见错误。

从 V 4.x 迁移的 Web 模块不会在更高版本的 WebSphere® Application Server 中运行。

注: 本主题引用一个或多个应用程序服务器日志文件。作为建议的替代方法，您可以将服务器配置为使用高性能可扩展日志记录 (HPEL) 日志和跟踪基础结构，而不是在分布式系统和 IBM® i 系统上使用 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 文件： Error 404: File not found: Banner.html Error 404: File not found: 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 应用程序在先前的版本上成功运行，但现在您遇到如下错误：找不到欢迎页面（通常是 index.html）或引用的 HTML 文件：

Error 404: File not found:
 Banner.html
Error 404: File not found:
 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”。

最佳实践: 您应该对每个应用程序中的 Web 模块使用不同的上下文根，或者使用应用程序服务器而不是代理服务器来访问 Web 模块。

有关当前 IBM 支持机构提供的已知问题及其解决方法的相关信息，请参阅 IBM 支持机构页面。

IBM 支持机构提供的文档能节省您在收集解决问题所需信息上花费的时间。打开 PMR 之前，请参阅 IBM 技术支持页面。