如何解决Jakarta EE项目中getServletContext()返回null的问题？

核心原因 #

getServletContext()返回null，大概率是以下两种情况：

1. 手动实例化Servlet：你自己通过new YourServlet()创建了Servlet对象，而非由Jakarta EE容器（如Tomcat、WildFly）托管实例。容器才会负责注入ServletContext，手动实例的对象没有上下文绑定。
2. init方法初始化错误：即使重写了init(ServletConfig config)，如果调用时机不对，或者在Servlet构造方法内调用getServletContext()（此时容器还未完成初始化），也会返回null。

具体修复步骤 #

1. 确保Servlet由容器托管

不要手动new Servlet实例，通过@WebServlet注解或者web.xml配置让容器管理：

@WebServlet("/user-submit")
public class UserSubmitServlet extends HttpServlet {
    // ... 你的业务代码
}

容器会在第一次请求时或启动阶段初始化Servlet，并自动注入上下文。

2. 正确重写init方法

如果需要自定义初始化逻辑，按以下两种方式之一实现：

• 方式一：重写无参init()

  @Override
  public void init() throws ServletException {
      super.init(); // 必须调用父类方法，保证上下文完成绑定
      // 在这里初始化MongoDB连接并存入上下文
      MongoClient mongoClient = MongoClients.create("mongodb://localhost:27017");
      getServletContext().setAttribute("mongoClient", mongoClient);
  }
  

• 方式二：重写带参数的init(ServletConfig config)

  @Override
  public void init(ServletConfig config) throws ServletException {
      super.init(config); // 这行必须保留，否则上下文无法注入
      // 自定义初始化逻辑
  }
  

⚠️ 绝对不要在Servlet的构造方法里调用getServletContext()，构造阶段容器还未完成上下文绑定，必然返回null。

3. 正确管理MongoDB连接实例

不要在每个请求方法（doPost/doGet）里重复实例化MongoDB客户端，应该将连接实例存入ServletContext复用，示例如下：

@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 获取表单输入参数
    String username = request.getParameter("username");
    String email = request.getParameter("email");

    // 从ServletContext获取预初始化的MongoClient
    MongoClient mongoClient = (MongoClient) getServletContext().getAttribute("mongoClient");
    MongoDatabase db = mongoClient.getDatabase("your-db-name");
    MongoCollection<Document> collection = db.getCollection("users");

    // 插入用户数据
    Document userDoc = new Document("username", username)
                            .append("email", email);
    collection.insertOne(userDoc);

    // 处理请求响应
    response.sendRedirect("success.jsp");
}

是否需要更换方案？ #

不需要。Jakarta EE Servlet + MongoDB是完全成熟的技术组合，只要修正实例管理和初始化的问题就能正常工作。如果你的项目支持Jakarta EE CDI（如使用WildFly容器），还可以进一步优化：将MongoClient封装成CDI Bean，通过@Inject注入到Servlet中，避免直接操作ServletContext，代码会更简洁易维护。

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