如何在Java SDK中为手动创建的Jetty服务器添加环境变量及VM选项？

一、关于JavaAgent的正确设置方式 #

你之前用org.eclipse.jetty.webapp.configuration参数设置JAVA_OPTS是错误的——这个参数是用来指定Jetty Web应用的配置类列表，和VM启动参数无关。

JavaAgent是JVM级别的启动参数，必须在JVM启动阶段加载，分两种场景处理：

1. 直接修改启动命令（推荐）
   如果可以控制启动当前Java应用的命令，直接在启动时添加-javaagent参数：

java -javaagent:some-javaagent.jar -jar your-main-app.jar

这种方式是官方推荐的，因为JavaAgent设计就是在JVM启动时初始化，后续动态添加会有诸多限制。

2. 动态加载Agent（复杂场景）
   如果无法修改启动命令，需要在代码中动态加载Agent，前提是你的Agent支持Agentmain方法（需查看Agent文档）：

import java.lang.instrument.Instrumentation;
import java.io.File;
import java.lang.reflect.Method;
import java.util.jar.JarFile;

public void loadAgentDynamically() throws Exception {
    File agentJar = new File("some-javaagent.jar");
    // 这里假设已通过Premain方法提前获取到Instrumentation实例
    Instrumentation instrumentation = getInstrumentationInstance();
    
    // 将Agent Jar添加到类加载器搜索路径
    instrumentation.appendToSystemClassLoaderSearch(new JarFile(agentJar));
    
    // 加载Agent类并调用agentmain方法
    Class<?> agentClass = Class.forName("com.example.AgentMainClass");
    Method agentMain = agentClass.getMethod("agentmain", String.class, Instrumentation.class);
    agentMain.invoke(null, "", instrumentation);
}

注意：这种方式依赖Agent的实现，且Instrumentation实例的获取需要提前通过Premain方法注册，使用非公开API获取会有兼容性风险。

二、给Web应用添加环境变量/系统属性 #

如果要给War包对应的Web应用设置环境变量或属性，有几种可行方式：

1. 设置系统属性（全局生效）
   在启动Jetty前，直接通过代码设置系统属性，Web应用中可以用System.getProperty()获取：

public void startServer() {
    // 设置系统属性
    System.setProperty("app.env", "production");
    System.setProperty("db.url", "jdbc:mysql://localhost:3306/mydb");
    
    Server server = new Server(0);
    server.setStopAtShutdown(true);
    WebAppContext webAppContext = new WebAppContext();
    webAppContext.setResourceBase(explodedWar);
    webAppContext.setExtraClasspath(getExtraClasspath());
    
    server.start();
}

2. 设置ServletContext属性（仅Web应用可见）
   如果只想让当前Web应用访问该属性，可通过ServletContext设置：

public void startServer() {
    Server server = new Server(0);
    server.setStopAtShutdown(true);
    WebAppContext webAppContext = new WebAppContext();
    webAppContext.setResourceBase(explodedWar);
    webAppContext.setExtraClasspath(getExtraClasspath());
    
    // 在WebApp启动前设置ServletContext属性
    webAppContext.addEventListener(new ServletContextListener() {
        @Override
        public void contextInitialized(ServletContextEvent sce) {
            sce.getServletContext().setAttribute("custom.env", "test");
        }

        @Override
        public void contextDestroyed(ServletContextEvent sce) {}
    });
    
    server.start();
}

Web应用中可通过request.getServletContext().getAttribute("custom.env")获取。

3. 设置进程环境变量
   如果需要设置进程级别的环境变量，只能在启动Java进程前通过操作系统命令设置，比如Linux下：

export APP_ENV=production && java -jar your-main-app.jar

代码中可通过System.getenv("APP_ENV")获取。

内容的提问来源于stack exchange，提问作者Valeriy K.