Vaadin应用路径上下文咨询及WildFly部署访问故障求助

Hey Vijay, since you're new to Vaadin, let's walk through common issues that cause this kind of access failure step by step:

1. 先修正访问路径的明显错误 #

• 首先去掉URL里的双斜杠：localhost:port//myapp/MyUIServlet 应该改成 localhost:port/myapp/MyUIServlet —— 双斜杠会导致WildFly解析路径出错。
• 如果你的Vaadin应用是根路径映射，尝试访问 localhost:port/myapp（可以试试带斜杠和不带斜杠两种情况，但先确保没有双斜杠）。

2. 检查Vaadin Servlet的配置（Servlet 3.0方式） #

Vaadin 7.7.x支持Servlet 3.0的注解配置（也可以用传统web.xml），确保你的代码配置正确：

注解方式（推荐Servlet 3.0） #

你的UI类应该类似这样：

@Theme("mytheme")
public class MyUI extends UI {
    @Override
    protected void init(VaadinRequest vaadinRequest) {
        // 先写最简初始化代码测试，比如只加一个Label
        setContent(new Label("Hello Vaadin!"));
    }

    @WebServlet(urlPatterns = "/*", name = "MyUIServlet", asyncSupported = true)
    @VaadinServletConfiguration(ui = MyUI.class, productionMode = false)
    public static class MyUIServlet extends VaadinServlet {
    }
}

重点检查：

• @WebServlet的urlPatterns：如果设为"/*"，访问localhost:port/myapp就会直接触发UI；如果设为"/MyUIServlet/*"，则需要访问localhost:port/myapp/MyUIServlet。
• 确保@VaadinServletConfiguration里的ui属性指向你的实际UI类（比如MyUI.class）。

web.xml方式（如果没用注解） #

如果你的项目用web.xml配置，确保里面有这段：

<servlet>
    <servlet-name>MyUIServlet</servlet-name>
    <servlet-class>com.vaadin.server.VaadinServlet</servlet-class>
    <init-param>
        <param-name>UI</param-name>
        <param-value>com.yourpackage.MyUI</param-value>
    </init-param>
    <init-param>
        <param-name>productionMode</param-name>
        <param-value>false</param-value>
    </init-param>
</servlet>
<servlet-mapping>
    <servlet-name>MyUIServlet</servlet-name>
    <url-pattern>/*</url-pattern>
</servlet-mapping>

检查url-pattern和UI参数的全类名是否完全正确。

3. 检查WildFly的部署状态 #

• 登录WildFly管理控制台（默认地址localhost:9990，用户名密码是你部署时设置的），找到myapp部署项，确认它的状态是已启动（没有红色感叹号或错误标记）。
• 查看WildFly的日志文件（standalone/log/server.log），搜索Vaadin或MyUIServlet关键字，看有没有部署时的错误，比如类找不到、依赖冲突、配置语法错误等。

4. 检查项目的依赖配置 #

如果用Maven，确保pom.xml里有正确的Vaadin依赖，并且排除Servlet API避免和WildFly自带的冲突：

<dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-server</artifactId>
    <version>7.7.13</version>
    <exclusions>
        <exclusion>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-client-compiled</artifactId>
    <version>7.7.13</version>
</dependency>
<dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-themes</artifactId>
    <version>7.7.13</version>
</dependency>

Gradle项目也要对应调整依赖，确保没有重复引入Servlet API。

5. 尝试最简测试项目 #

如果上面都没问题，建议创建一个极简Vaadin项目测试：

• 只保留一个UI类，配置好Servlet注解，初始化方法里只添加一个简单的Label。
• 打包成war部署到WildFly，再访问对应路径，排除复杂业务代码的干扰。

如果还是无法访问，把WildFly日志里的错误信息贴出来，这样能更快定位问题！

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